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Preface 


About This Manual 


The AppleCD SC Reference provides information for experienced computer users, 
system administrators, and programmers who want to take advantage of the features of 
the AppleCD SC®. To use this manual, you should have some knowiedge of a 
programming language, such as BASIC, Pascal, C, or assembly language, and you 
should be familiar with the computer with which you intend to use your AppleCD SC. 


You do not need to use this manual when simply running packaged programs for your 
Apple® computer. However, this manual can help you if you are running a program 
that can be configured to take advantage of the features of the AppleCD SC, or if you 
are writing or modifying a program that uses the AppleCD SC. 


Instructions for connecting the AppleCD SC to your computer, inserting CD-ROM 
cartridges, and other routine operating tasks are provided in the AppleCD SC Owner's 
Guide that came with your AppleCD SC. 


This preface describes the contents of this manual, and the visual cues and 
conventions used throughout the book. It also lists some other books that you may 
wish to refer to when using this manual. 


vil 


What this manual contains 


AppleCD SC Reference describes the operating modes and special capabilities of the 
AppleCD SC as well as the hardware and software interface to the host computer. 


The following is a brief outline of the contents of this manual. 


0 


0 


Chapter 1, “Introduction to CD-ROM,” includes a description of the features and 
possible uses for AppleCD SC. This chapter steps through the data preparation 
process for creating information to be placed on CD-ROMs. 


Chapter 2, “AppleCD SC Software,” provides a functional description of how the 
Macintosh and Apple I software works at the operating system level to allow the user 
to read data from the AppleCD SC. 


Chapter 3, “High Sierra and AppleCD SC,” includes an overview of the High Sierra 
file system, and describes how it differs from the native HFS and ProDOsS interfaces 
on the Macintosh and Apple 1. 


Chapter 4, “HyperCard and CD-ROM,” describes considerations for choosing a 
retreival model. It explains the advantages of using HyperCard as the data retrieval 
engine or as an interface layer between the retrieval engine and large databases. 
This chapter provides examples of HyperCard retrieval interfaces, and describes 
how one can utilize HyperCard XCMDs to bring existing database libraries into the 
Macintosh environment. 


Chapter 5, “Networks and AppleCD SC,” provides implementation-specific 
information.for using AppleCD SC as a server on a network. 

Chapter 6, “AppleCD SC Functional Overview,” provides a general overview of the 
hardware and firmware components of the AppleCD SC drive and includes a 
functional block diagram of the AppleCD SC drive. 

Chapter 7, “AppleCD SC CD-Audio and Sound Production,” provides a 
description of how to implement the stereo-CD capibility on AppleCD SC. The CD 
Remote DA for Apple Ile is used as an example. 

Chapter 8, “AppleCD SC SCSI Commands,” includes the AppleCD SC device- 
specific SCSI command descriptions. 

Appendix A, “AppleCD SC Specifications,” lists the specifications for the AppleCD 
SC. 


The table of contents provides a complete list of the subjects covered in each chapter. 
This book also contains a glossary of technical terms used in the manual, and an 
index. 


How to use this manual 
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This manual provides information for programmers and developers with a variety of 
needs and levels of experience. The following guidelines can help you get the most out 
of this book. 


O If you are not writing programs but are interested in learning more about CD-ROMs 
in general, and about the AppleCD SC in particular, read Chapters 1, and 6. Look 
through the rest of the book to get an idea of the kinds of tasks the AppleCD SC can 
do. You might also want to read Chapters 2, 4, 7 and 8 to learn about all the 
considerations involved in writing programs for your AppleCD SC. 


If you are using this book to learn how to configure or customize a program to take 
advantage of the AppleCD SC’s features, read Chapters 2, 3, 4 and 8. 

If you have experience writing programs that use CD-ROMs, but are unfamiliar with 
the AppleCD SC, look through Chapters 1 through 5 to learn about the features and 
options available. Then go back to the detailed description of a command in 
Chapter 8 when you are ready to use it. 


O 
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Visual cues and conventions 
Look for these visual cues throughout the manual: 
* Note: Notes like this contain supplementary information. 


Warning Wamings like this direct your attention to something that could 
damage either software or hardware or result In loss of data. 


Terms in boldface type are defined in the Glossary. 
A special typeface is used for characters that you type or for lines of program code: 
It looks like this. 


In general, commands are sent to the AppleCD SC with no spaces between characters 
in the command. Spaces between characters in sample commands in this manual are 
for legibility only. When oe space character is included as part of a command, it is 
shown as SPACE. e 


Hexadecimal numbers are eer by a dollar sign ($), except in tables where 
hexadecimal numbers are clearly labeled. For example, the hexadecimal equivalent 
of decimal 16 is writen as $10. 


Where fo look for more information 


Where to icok for more information 


AppleCD SC Reference assumes that you are familiar with CD-ROM technology and 
many of the possible uses for CD-ROM. However, additional information and ideas 
are presented in these documents: 

O The AppleCD SC Owner's Guide, which is shipped with every AppleCD SC, explains 
how to set up a AppleCD SC in the standard configuration. The manual gives basic 
operating information, such as how to insert, eject, and store discs. 

O Inside Macintosh published by Addison-Wesley. 

CQ The Complete HyperCard Handbook by Danny Goodman, published by Bantum 
Computer Books. 
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Introduction 
fo CD-ROM 


The AppleCD SC Reference is primarily for the professional developer or information 
provider interested in working on CD-ROM products for use with the Macintosh or 
ApplelI computers. The AppleCD SC Reference also serves to provide basic 
information for anyone interested in knowing about CD-ROM. To satisfy these diverse 
audiences, this introduction contains basic information about CD-ROM, the 
AppleCD SC, and things you need to know before you decide to develop software or 
put information on CD-ROM to be used with the Macintosh and Applell. 


If you already understand CD-ROM and the steps involved in the CD-ROM creation 
process, but are interested in learning about the AppleCD SC device software, you 
may want to skip ahead and start your reading at Chapter 2. 


What is CD-ROM? 


CD-ROM Compact Dtsc-Read Only Memory is a non-magnetic storage and retrieval 
medium for large amounts of digital data. The principle users of CD-ROM and 
AppleCD SC are personal computer users, using either the Macintosh or ApplelI. CD- 
ROM is a relatively new technology, which stems directly from the CD-Audio Compact 
Disc-Audio industry. Like CD-Audio, data on CD-ROM is stored on a hard plastic 
disc, measuring 12 centimeters (43/4 inches) in diameter and slightly over one 
millimeter thick (1/20 inch). 


A CD-ROM can store 656 megabytes of text, or up to 748 megabytes of graphics. You 
could compare that to about 200,000 single-spaced typewritten pages, or the contents 
of 935 floppy disks with a capacity of 800 kilobytes each. Data on a CD-ROM is not 
limited strictly to text and graphics. Anything that can be digitized for use on the 
computer can be stored on CD-ROM. Examples of commonly digitized data include: 
computer applications software, sound, music, and graphics. 


The popularity of CD-ROM is not only based on its high capacity for data storage, but 

other admirable qualities, including: 

@ Information on CD-ROM is stored as Read Only Memory, which means it cannot 
be changed or deleted. 


w CD-ROM provides immediate access to large amounts of information, and allows 
easy, rapid cross-referencing of information. 


The discs are constructed of high impact polycarbonate and are not susceptible to 
damage by scratches, dust, magnetic fields, or water like floppy disks are. 
Additionally, when a disc is placed in the AppleCD SC caddy, it is basically free 
from any possible dangers of miss-handling in the typical office environment. 
CD-ROM mastering and reproduction costs are quite low on a per megabyte basis, 
and continue to decrease as CD-ROM technology increases. 


Unlike Videodisk, and other standards, such as CD-I, it is possible to simulate a 
CD-ROM’s performance characteristics before actually producing the disc, thereby 
reducing some of the cost of product development 
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Given that the CD-ROM is small, nearly indestructible, and has the capacity for 
storing large amounts of data, it is an ideal way of getting information into the 
personal computer user’s hands. The next section describes some of the possible uses 
for CD-ROM and AppleCD SC. 


ideas for information access 


You might wonder about the possible uses for CD-ROM. What appears to be just 
another incredibly large disc, particularly one that you can’t write to, may not seem 
very useful at first glance. To help dispel any negative thoughts about the usefulness of 
CD-ROM, you should be aware that there are plenty of interesting and valuable 
applications currently available and many other exciting possibilities being worked 
on. 


CD-ROM is an excellent vehicle for widely dispersing extremely large databases of 
information. Some examples of the areas in which CD-ROM would be most useful are: 


Art and publications 

C Graphic image data bases 

© Dictionaries,thesauruses, and style guides 

C Design element, glossary, and document boiler plate databases 
Education 

C Interactive tutorials 

O Multi-lingual audiovisual dictionaries and encyclopedias 
Industry 

© Manufacturer parts lists, which break down unit assemblies into components 

lists. 

© Component and product specifications 

O Engineering and mechanical drawings 

O On-line technical documentation 
Government & legal 

© US federal trademark information with graphics 

CO Agency regulations 

O Court decisions 

O Census data 

O Maps at national, state, regional, and metropolitan level 
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Finance 
© Financial statements 
O US federal tax forms 
0 Market research and analysis reports 
© Stock market history 
Science and medicine 
O Cancer research data 
© Medical dictionary 
O Scientific writings 
CO Toxicology database 
Reference 
O Encyclopedias 
© Library catalogs 
O Periodicals and newspapers 
As you can see, there are plenty of areas to explore, and this list only touches on the 


possibilities. Later in Chapter 4, an example of a possible Macintosh interface for a 
CD-ROM educational reference is presented. 


Why put information on CD-ROM? 


Let’s consider the advantages of the CD-ROM over conventional reference media, 
such as books, on-line services, or floppy disk, any one of which might supply the 
same type of information listed above. 


One of the advantages of CD-ROM is that it doesn’t take up as much space as the other 
reference media. For example, an entire collection of encyclopedias on your desktop 
would be hard to handle and cumbersome to search through. On the other hand, a 
AppleCD SC with an entire encyclopedia on CD-ROM could fit under your computer, 
or be placed away from your work area, and with the right application software the 
AppleCD SC would supply information. with just the click of the mouse. Also, given the 
strength of the Macintosh’s cut and paste functionality, this diverse amount of 
information can be easily integrated into a user's productive environment. The user 
would no longer need to struggle with a large stack of encyclopedias. 
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In an office where many people might use on-line services to access information, CD- 
ROM can be an inexpensive and more efficient alternative. On-line services run on 
the phone lines, and phone lines generally don’t provide the data transfer rates of a 
AppleCD SC connected directly to your computer. Slow transfer rates over the phone 
lines means that searching for information and moving it into the computer memory 
for use will be comparatively slow, frustrating process for the user. Additionally, 
connect time can be very expensive. Having the ability to quickly search and transfer 
data from the CD-ROM connected to the computer is going to make the user happier 
and save on the operating overhead created by excessive use of the phone lines. 


The advantages of CD-ROM over floppy disks are fairly obvious from most of the 
information presented earlier. CD-ROM holds far more information, it’s not easily 
destroyed, and can’t be inadvertently erased. 


For more information about the technology and construction of CD-ROM and how 
the AppleCD SC reads the data on the disc, see “AppleCD SC Functional Overview,” 
Chapter 6. The next section provides an overview of the AppleCD SC features. 


AppleCD SC features 


The AppleCD SC, shown on Figure 1-x1, provides a CD-ROM solution for both the 
Macintosh and AppleII computers. AppleCD SC has the following features: 


w AppleCD SC has the same footprint as the SC20 hard disk, the SC40 tape backup, 
and other Apple high capacity storage devices. The AppleCD SC’s standard 
footprint and compact design allow it to fit under the Macintosh Plus, and 
Macintosh SE. AppleCD SC can also be easily stacked with additional Apple 
peripheral devices. 


ws AppleCD SC is a SCSI Small Computer System Interface device, which is easily 
connected to the Macintosh Plus, SE, and I, as well as the Apple Ile and IGS 
configured with an Apple II SCSI card (A2B2087 rev. C ROM or later). AppleCD 
SC can be daisy-chained within a group of up to seven SCSI devices, which may 
include additional AppleCD SCs. 


m AppleCD SC reads CD-ROM and plays audio CDs audio compact discs. In 
addition to the variety of CD-ROM applications available for your use on both the 
Macintosh and Applell, you can also listen to any of your favorite stereo CDs by 
using the CD Remote desk accessory and a set of externally powered speakers or 
stereo headphones. The CD Remote desk accessories are supplied with the 
AppleCD SC. 


= AppleCD SC has a pair of stereo RCA jacks for connection to amplified speakers, a 
headphone jack, and a volume control. 


w AppleCD SC has a built-in 64K data buffer to maintain maximum data transfers to 
the host computer. 


What is CD-ROM? 


m AppleCD SC supports the Phillips/Sony CD-ROM Yellow Book industry standard 
for modes C1 and C2 and the CD-Audio Red Book standard. 


(For more information about the technical features and specifications of the AppleCD 
SC drive, see Chapter 6, “AppleCD SC Technical Overview” and Appendix A. 
“Specifications”) 


| 
| 
Figure 1-1 | 
AppieCD sc 
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Creating a CD-ROM—What’s involved? 


Although few conventions currently exist for CD-ROM product creation, this section 
attempts to generically categorize and explain the process. The step-by-step process 
to create a CD-ROM is presented in Figure 1-2, and described in the text following the 


block diagram. 
Product rnb the 
| design elvery 
system 
- Data : 
collection 
Data Data 
preparation conversion 
Data 
indexing 
Logical 
formatting 
Disc | | 
a Masteri 
Finished product 
Figure 1-2 


The steps to create a CD-ROM 
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Product design 


Your product design is the key point from which you base all of your future decisions. It 
also serves to ensure that your first time results are in fact your intended results without 
doing the process again. A good product design focuses on a particular audience. To 
decide on what audience your product will be aimed at, you must first thoroughly 
analyze the audience’s potential market share and what other competitive products 
already exist for that audience. From this analysis you can decide what information, 
features, and functions will be required to make your product successful with your 
chosen market audience. | 


The product design also includes considerations for disc contents, product price, 
packaging, distribution channels, and the estimation of time and effort required to 
meet your target goals. To help you with your decisions about the product design, 
consider these questions: 


1. How is the data currently presented? Is the data in the form of books, disks, 
monthly periodicals, and so on? 
What audience or audiences see the data as valuable? 
Does the audience use the data as it is currently presented? 
How can the presentation be improved on CD-ROM? ; 
How can the data be economically converted into machine readable form for ( 
use on CD-ROM? . 
O Does it need to be converted from tape? Tape includes both video and audio. 
© Does the data have to be keyed on a word processing system, or can the data be 
captured by other techniques, such as an optical character reader (OCR), or in 
the case of graphics, image scanning? 
O Does the data require a lot of formatting for screen presentation and editorial 
cleanup. 
6. How often will the data need to be updated and how will updates be handled? Will 
the product be a service with monthly or quarterly updates, or will you notify the 
customer of an update, giving them the option to purchase the new material? 
7. Will you have to license the information from an information provider? 


8. What kind of retrieval software will best serve your customer? Will you create a 
customized retrieval engine or license a general purpose one. 

9. Will the retrieval and application software be on the CD-ROM or on floppy 
diskette? It is generally best to have the software distributed on floppy disk, 
because you may want to have the flexibility to upgrade without mastering 
another series of CD-ROMs. 

10. Will you license the product or sell it outright to the customer? 


11. How will the product be packaged? Will you need special graphics for your disc 
label and package presentation? : 


WM mH WwW 
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12. How will you deliver the product? Through computer dealerships, software 
outlets, direct sales, or will you use it exclusively within your own company? 


Another key element for a successful product designed to work in the Apple computer 
market is the user interface. This really can’t be over emphasized, Apple computer 
users expect an interface that: 


O extends the Apple desktop metaphor (described in the “Human Interface 
Guidelines, The Apple Desktop Interface,” which is available from Adison 
Wesley) 


O is rich in graphic elements 


© provides ease of integration into the user's work environment by being consistent 
and following the Human Interface Guidelines 


0 is intuitive and requires very little tutorial documentation, so that the 
discretionary and professional user feel equally at home 


O incorporates compatibility for future updates 


Defining the delivery system 


During this stage of the CD-ROM creation process you analyze how your CD-ROM 
data is going to be delivered to the user. Here the term delivery refers to hardware and 
software delivery, rather than distribution and sales delivery. The target delivery 
system for CD-ROM products for the AppleCD SC is the Macintosh and ApplelI. The 


typical questions you must focus on during the defining of the delivery system stage 
are: 


1. What type of software is going to make the product valuable and exciting to the 
customer? 


2. Who will engineer and maintain the software? 


3. What is the target machine? If you are an information provider you may want your 
data to be accessible by more than one brand of computer. 


4. Does your product require the use of special hardware, such as a large screen color 


monitor or a laser printer? Will your target audience be willing to purchase a 
product that requires special equipment’ 

5. Will you provide a complete CD-ROM solution, which includes the computer 
hardware delivery system and your CD-ROM? 


If you plan to market a complete CD-ROM solution, which includes system hardware 
and software, here are some additional marketing issues that will require your 
attention: 


1. How will you deliver the hardware? Will you sell it outright, lease it, or package it 
with a product subscription? 
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2. Where will you procure the system components? Will you purchase the 
components from a system integrator, or buy them direcuy from a dealership or 
manufacturer? 


3. How will the system be serviced and warrantied? 


Software development 


If you are an information provider, you have several things to consider. Do the 
software development in-house or contract the work from an outside source. Having 
an in-house programmer (or programmers) that understand the target computer and 
operating system is ideal for software product support and fast turnaround when 
developing fresh ideas. If you are a software developer, particularly a developer that 
has not worked with Apple CPUs and software before, you also need to decide whether 
to bring Apple expertise in-house for your project. 


Regardless of whether you bring the software expertise in-house or contract on the 
outside, you still need to analyze how the retrieval software will be handled. Are you 
going to start from scratch and create your own retrieval engine, or license a general 
purpose engine and enhance the functionality for your application? 


Software development for CD-ROM encompasses several areas. You need to decide 
what areas of the software you intend to do yourself and which areas should be 
contracted or licensed from other sources. The amount of work for each area of 
software development will depend largely on the specifications of your product oO 
design. The list that follows provides a good preliminary outline of the areas of ‘ 
software development where you need to concentrate your efforts. 


@ The development of the user interface for either or both the Macintosh and Applel 
families of computers. (The “Human Interface Guidelines, The Apple Desktop 
Interface” which is available from the Addison Wesley, provides an excellent 
reference for implementation of the Apple desktop interface metaphor.) An 
example of a desktop interface that follows the ideas presented in the Human 
Interface Guidelines reference is provided in Chapter 4. 


m The programming of the retrieval software (sometimes referred to as the retrieval 
engine) for a new Apple product, porting an existing retrieval engine so that it works 
on either the Macintosh or Applell, or licensing existing retrieval software that has 
been created for the Macintosh or Applell. The retrieval engine is the software that 
actually does the search requested by the user interface. A description of CD-ROM 
retrieval engines is provided in Chapter 4. 


@ Programming device resources (commonly referred to as device drivers) for 
application output. If your CD-ROM product design calls for the application to 
output to devices not currendy supported by Apple device resources, you need to 
provide device-specific resources for your application. For example, output 
devices might include: typesetting equipment, printers, plotters, and so on. 
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w Building the index for your CD-ROM retrieval software. The index is a key element 
for locating words on the CD-ROM during the search process executed by the 
retrieval software. 


w Localizing your interface for foreign countries. This would include development or 
purchase of special character sets, and translating the language in your data base 
and interface. Information for localizing Macintosh applications can'be found in 
both “Inside Macintosh” and the “Human Interface Guidelines, The Apple Desktop 
Interface.” 


The interface, the retrieval engine, the data, and the index are going to be the pieces 
of your software development effort that together make up your application. To 
produce an efficient CD-ROM application, these phases of software development 
must be carefully thought out and closely tied to each other. 


Data preparation 


The data preparation phase includes several steps, which are made up of some areas 
requiring considerable expertise. As you saw in Figure 1-2, the data preparation step in 
the CD-ROM creation process is generally made up of three areas: 

m Data collection 

m Data conversion 


m Data indexing 


Data collection 


This step is often referred to as the data capture step, because it inchides both the 
creation and the transformation of original data from diverse sources and conversion 
of that data into one format. For example, the data could be binary, line drawings, 
photographs, video film, word-processing files, or it may not yet exist in a machine 
readable form. 


To get the data into a useable form, you first create and convert all dissimilar types of 
data into a format that can be read by a computer. This may involve digitization of 
analog sound, graphics, text, video tape, and so on. 


The data capture step is one of the areas that may require expertise from outside 
vendors. Getting data, which may exists only in books into machine readable form 
requires many hours of keying the data into a computer. If you are not set up to do alot 
of keying, this task is better left to vendors that specialize in word processing. If 
resources and the proper equipment is available, conversion of photocomposition 
tapes, digitization of analog sound, OCR of text data, and scanning of graphic images 
can be done in-house. _ 
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Data conversion 


After the data has been converted into a machine readable form, it may still not be in 
a form that the retrieval and indexing software will be able to use. It is during the data 
conversion stage that you reformat and code the data to be read, displayed, and 
indexed. For example words, paragraphs, pages, chapters and section markers may 
have to be encoded so they can be indexed for your retrieval software. Additionally, 
you need to perform as much error correction on the textual data as possible. Typical 
errors yOu want to catch and correct are: all spelling, formatting, style, and outdated 
material errors. Error correction during the data conversion stage is important, 
because the next phase of data preparation, data indexing, will index all overlooked 
errors along with the good data. Catching and correcting the errors later in the 
production cycle will be costly and cause time delays in your project schedule. 


You will also need to monitor the total size of your text, graphics, and sound data. If 
the data exceeds the size of your disc, you may need to consider data compression. 
Also remember that if you do compress the data, it will have to be decompressed later 
when it is displayed on the screen. The data compression stage is done with software 
and in some cases hardware, which may add considerably to your production costs 
and the cost of the product to the user. 


If you plan to produce a product which includes sensitive or programming data that 
you want to protect so that it is not easily copied, you will also want to encrypt the data 
during the data conversion process. Here again, the data encryption process requires 
the use of special encryption and decryption software, which may add to the cost of 
the final product. 


Data indexing 


In the same way that an index for a book allows you to find information quickly, data 
indexing allows the retrieval software to quickly locate information on a CD-ROM. The 
index provides a table of word occurrences for every word and the location of each 
word on the CD-ROM. Due to the quantity of data and slower access times of the 
typical CD-ROM, it is necessary that all data be indexed, otherwise data retrieval 
could take an unacceptable amount of time. The structure of the data index is closely 
tied to the retrieval and application software. Indexing schemes vary according to the 
type of dara and presentation being provided to the user. For example, a full-text 
reference product that presents formatted pages of information to the user would 
require a list of every word, chapter head, paragraph, and sentence. Each application 
design may require a slightly different method of indexing to make it efficient and 
useful with the data. 
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Logical formatting 


The logical formatting stage places all of the text, graphics, sound, or other forms of 
data into a unified file swructure onto 9-track, ¥2 inch magnetic tape. It is from this 
unified structure that your file management software is able to find and retrieve data 
from the disc. Your choices here are to use a format readable by the target machine or 
pick a format that is accepted universally. For example, the ProDOS file format for the 
Apple II family, or the HFS file format for the Macintosh family. If you elect to use 
either of the Apple formats, of course your disc will become machine dependent. 
Alternatively, you could convert all the data into the High Sierra format, which would 
make the disc readable by most of the computers that support the CD-ROM High 
Sierra format. (The High Sierra format is discussed in Chapter 3, “High Sierra and 
AppleCD SC.") 


This is also the time to test and optimize your retrieval software, and physically 
arrange the layout of data for the tape. For example, if you plan to have audio playing 
at the same time an animated graphic or text screen is scrolling, you will want to have 
the graphics or text and audio data tracks as close to each other as possible. 


The logically formatted tape should be an ANSI compatible tape or tape set formatted 
to Level 3 of the ANSI “Standard for Magnetic Tape Labels and File Structure for 
Information Interchange” (X3.27-1978). The tape recording density can be either 
6250 or 1600 BPI. The information on the tape should be an exact data image of what 
the CD-ROM manufacturer will transfer to the CD-ROM master. All of the CD-ROM 
mastering facilities can supply more information about the requirements for the tape 
format. 


Disc mastering 

The CD-ROM disc mastering process includes: 

@ premastering 

@ mastering 

w replication and packaging 

If resources are available, you can use one of the microbased premastering subsystems 
for CD-ROM development. CD-ROM development subsystems allow you to actually 
build the logically formatted tape, and do realtime simulation of the CD-ROM 


environment. Micro-based subsytems also have the capability of preparing the 
premastered tapes in-house. 


If the appropriate software is available, premastering can be performed on any 
number of computer systems that have large disk and tape storage capabilities. The 
mastering and replication stages of the CD-ROM creation process are done by firms 
that specialize in CD-ROM manufacturing. 
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Premastering 


After the logically formatted tape has been made, it is sent to a CD-ROM mastering 
and manufacturing facility. The mastering facility processes the data on the tape, 
adding error detection and correction information. The combination of data and 
error correction information makes up the final CD-ROM format, which will be used 
in the CD-ROM mastering process. If the appropriate software is available, and you 
are using a microbased premastering CD-ROM development subsystem, the tapes 
may already have the error correction information and be ready to be used in the CD- 
ROM miastering stage. 


Mastering 


During the mastering stage a CD-ROM master disc is made. A simplified diagram of 
the CD-ROM mastering process is shown in Figure 1-3. The mastering process starts 
with a glass disc that is coated with a photoresist layer. Using extremely fine tolerance 
equipment a laser beam is modulated synchronously with the digital information on 
the premastered tape. The modulated laser beam exposes the photoresist layer on the 
surface of the spinning glass disc and records the digital information. Photo 
developing chemicals are applied to the exposed photoresist layer, which cleans the 
glass master leaving only the digital imprint created by the laser beam. Then a nickel 
layer is applied to the disc creating a metal master stamper. To preserve the master 
stamper, several additional metal stampers are made for later use in the CD-ROM 
replication process. 


ere 


ue. a 


Figure 1-3 
Tne steps involved In the CD-ROM mastering process 
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Replication 


During disc replication, the metal stampers are used in a transfer molding process to 
make an exact imprint of the information surface on polycarbonate discs. The 
polycarbonate discs are coated with a thin reflective aluminum layer, as shown in 
Figure 3. The aluminum layer is then coated with a protective plastic, and the CD- 
ROM label is silk screeened on the plastic layer side of the disc. 


Packaging 


This stage puts the CD-ROM product together in the finished form with all of its pieces. 
The packaging pieces generally include: the package the CD-ROM will be contained 
in, the user documentation for the product, warranty and additional services 
documentation, and the shipping container. Many of the CD-ROM mastering 
facilities provide a service that takes all of the pieces of your CD-ROM product, puts 
the pieces together, and ships the finished product to your distribution center or end 
user. 


Equipment and software for CD-ROM product development 


In this section we assume that you are interested in providing information or creating 
retrieval software for Macintosh or Applell computer users. This group of computer 
users will also be using your CD-ROM product on the AppleCD SC. Here are some 
things you need to consider before getting started. 


What kind of equipment works best for compiling information and retrieval software 
for Apple computers? 


Do you want to create a CD-ROM made specifically for Apple computers? 


Do you want to use a CD-ROM that has already been pressed in High Sierra format and 
provide a retrieval interface for the Macintosh or Applell? 


Where can you save money when developing an Apple CD-ROM product? 
The information that follows attempts to answer the questions presented above. 


There is always one question that comes up when computer equipment and software is 
mentioned. What is going to give me the most bang for the buck? We know that not 
everyone has all the money they would like to have when getting started on a new 
venture, so the following list starts with the minimum hardware and software 
configuration for Macintosh and ApplelII CD-ROM product development. 
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Developing software for a Macintosh 


If you plan to develop CD-ROM products for the Macintosh Plus, SE or I, the 
hardware and software that provides the fastest turnaround for the smallest investment 
is a Macintosh II configured with a minimum of 5 megabytes of memory, a 
monochrome monitor, a keyboard, an Apple HD 80SC, and whichever Macintosh 
target machine you plan to run the software on. If your product is targeted for the 
Macintosh II, and you intend to use color graphics as part of your product, you need to 
add the Macintosh II color graphics card configured with extended memory and a 
Macintosh I color monitor or compatible to your system. 


The ideal development software for the Macintosh is the Macintosh Programmer's 
Workshop (MPW) Shell. The MPW shell is a robust integrated, window-based 
environment for program editing, file manipulation, linking and program execution. 
The system also includes many other tools that create and manipulate text and 
resource files. C, Pascal, and Assembly languages are available for the MPW shell. 
Brief descriptions of the MPW tools, and languages are as follows: 


C Macintosh Workshop C: A C compiler that runs in the MPW Shell. It provides the 
tools, interfaces, and libraries to develop applications written in C. 

© Macintosh Workshop Pascal: Provides the tools, interfaces, and libraries to 
develop applications written in Pascal. 


G MacApp: An expandable generic application that can greatly simplify and speed 
the process of software development. MacApp consists of a set of object-oriented 
libraries that implement the standard Macintosh user interface in such a way that 
you can write applications as extensions to MacApp. 


Depending on the programming language you'll be using, you may want to order one 
or more of the MP'W reference manuals listed below. 

C Inside Macintosh Volumes I, I, and IV 

CO MPW Reference Manual 

CO MPW Assembler Reference Manual 

OC MacApp Programmer's Reference Manual 

CO MPW Pascal Reference Manual 

OQ MPW C Reference Manual 


MPW, the accompanying tools and languages, and documentation are available from 
the Apple Programmer's and Developer’s Association (APDA). 


Development time for the user interface portion of your Macintosh CD-ROM product 
can be greatly reduced with the use of HyperCard. To learn more about how 
HyperCard can help you to quickly build Macintosh user interfaces, see Chapter 4, 
“HyperCard and AppleCD SC.” 
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Developing software for the Apple II family 


If you plan to develop CD-ROM products for the Apple II, the hardware that provides 
the fastest turnaround for the smallest investment is a Apple IIGS configured with 1 
megabyte of memory, a monochrome monitor, a keyboard, an Apple HD 80SC (80 
megabyte hard disk), and the Apple II target machine. The software to use with the 
Apple II is Apple Programmer’s Workshop (APW). 


APW, the accompanying tools and languages, and documentation are available from 
the Apple Programmer’s and Developer's Association (APDA). | 
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Chapter 2 


AppleCD SC 
Software 


This chapter describes the interaction between the AppleCD SC device driver and the 
Macintosh operating system managers. It also provides the AppleCD SC system-level 
device control and status calls for the Apple Il SmartPort interface and the Macintosh 

device driver. 


What makes the AppleCD SC work? 


The AppleCD SC device driver is the device controller software that provides a 
nonspecific interface to system software. The device driver services requests from the 
computer by receiving commands from the computer's operating system and 
converting those commands into device activity. 


The purpose of the CD-ROM device driver, AppleCD SC, is to provide the software 
connection between Apple Macintosh computers (Mac Plus, Mac SE, and Mac II) and 
the AppleCD SC. This release of the driver also provides limited support to the 
Toshiba XM-2000A and Philips CM 110 CD-ROM drives for software development 
purposes. Both HFS-compatible and non-HFS discs can be accessed with the driver 
using standard File Manager and Device Manager procedure and function routines. 


In addition, the AppleCD SC device driver monitors disc inserts and ejects, which 
gives the AppleCD SC drive the functional appearance of the familiar 800K drive. 
Other related activities, such as dragging the AppleCD SC icon to the trashcan to 
unmount and eject a disk, and selecting a file on an AppleCD SC, can also be done by 
using a standard SFGetFile dialog. For more information about standard file 
routines, suchas SFGetFile, see Inside Macintosh 


Macintosh applications communicate with these drives by executing certain operating 
system routines. The AppleCD SC device driver provides the software interface 
between the AppleCD SC and the Macintosh operating system. 


After the AppleCD SC device driver has been properly installed and initialized, any 
application can read data from a mounted AppleCD SC drive by issuing Device 
Manager calls. The Device Manager, part of the Macintosh operating system, controls 
device behavior by sending commands to the AppleCD device driver. The AppleCD 
device driver, in turn, sends specific activity requests to the AppleCD SC. The 
relationships in the device software environment are shown in Figure 2-1. 


2-2 Chapter 2: AppleCD SC Software (Alpha craft) 


subroutine specific 
calls and Device Mor traps device 
parameters and parameter bik. commands 


the the | the ca 
application operating device ie 
system driver device 
data, data and | data a 
status info, updated status info 
and error code parameter bik. 


Figure 2-1 
Device software environment 


The AppleCD SC device driver 


The AppleCD SC device driver functions are divided into three major functional 
areas: 


0 AppleCD SC device driver and device initialization 
O Data acquisition and device control 
CO Disc insert event monitoring 


What follows is a narrative description of the activities in each of these areas. 


Apple CD SC device driver and device initialization 


The driver is initialized at boot time when the Macintosh is powered on. The AppleCD 
file in the System Folder contains a number of resources, as shown in Figure 2-2. The 
two which interest us are the ‘INIT’ and 'DRVR' resources. . 
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Figure 2-2 
AppleCD device driver resources 


One procedure the System performs during startup is to look in the System Folder for 
all files of resource type 'INIT’. If one of these is found, the System will then look for an 
'INIT' resource in that file to load and execute. The AppleCD file meets this 
specification. 


The first task of the INIT routine is to look on the SCSI bus for CD-ROM drives. If the 
CD-ROM drive is powered on and appropriately answers both a SCSI Test Unit 
Ready command anda SCSI Inquiry command, a CD-ROM drive is recognized 
and considered to be active. If ther is no response to the Test Unit Ready 
command, the search continues with the next SCSI id. After the first drive is found, the 
'DRVR' resource, the actual device driver, is loaded into system-heap memory and 
locked in place. Then the ‘INIT installs the driver into the unit table, which is an array 
of driver references maintained by the operating system. After installing the driver 
into the unit table, the 'INIT' looks for additional CD-ROM drives assigned to other 
SCSI id numbers. If any are found, they are installed in the unit table as well. After this 
is complete, the 'INIT’ builds a parameter block, fills in the CD-ROM driver name, 
AppleCD, and passes a pointer to the parameter block in an Open call to the Device 
Manager. The Device Manager opens the driver by first filling in a few more fields in 
the parameter block, then locating and executing the driver's Open routine. Control 
eventually returns to the Device Manager and then to the 'INIT. All that is left is to 
return control to the System. 


® Note: If no CD-ROM drives are found, the 'INIT' retums control to the System and 
the normal system startup process continues (executing other INITs, launching the 
Finder, and so on.). 
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By the time the Open routine is executing, the Device Manager has already put more 
information in the fields of the parameter block. One such field is the ioRefNum, a 
driver reference number the Device Manager computes based on the driver's position 
in the unit table. The Open routine uses this number and computes backwards, so to 
speak, to find out the SCSI id of the first CD-ROM found by the 'INIT’. In fact, any time 
the driver gets control from the Device Manager, the SCSI id of the requested device is 
determined in this manner. The id is required by all the SCSI commands the driver 
sends to the CD-ROM drive. 


Because three different drives are supported, and certain SCSI commands differ from 
drive to drive, the Open routine next obtains manufacturer identification data from 
the drive it is currently looking at. Then, the drive is added to the drive queue and a 
flag, used elsewhere in the driver, is set to show that a drive is attached with the current 
SCSI id. 


Following this, the Open routine looks in the unit table for other CD-ROM drives. 
For each one found, the same procedure occurs: determine the drive's manufacturer, 
add the drive to the drive queue, and mark the related "cd" flag. 


After all drives have been processed, the Open routine installs a VBLTask in the 
vertical retrace queue which monitors both disc inserts and disc ejects once every half- 
second (discussed under Disc insert event monitoring). 


Finally, the Open routine returns control to the Device Manager. 


Data acquisition and device control 


As detailed in *The Device Manager’, chapter of Inside Macintosh, Volume 2, an 
application communicates with devices through the Device Manager. The Device 
Manager translates the application's requests into specific commands to the device 
driver. The driver, then, converts the commands into actual device activities. 


Applications may execute five basic Device Manager operations. Open calls give the 
driver an opportunity to allocate and initialize local variable space as well as 
performing any necessary device-startup operations. The Close call signals the 
driver to reverse the actions of the Open call by releasing local variable space back to 
the System. The Prime call is the data transfer call; in the case of CD-ROM, this is 
the Read call. Finally, Control calls request that control information be sent to the 
device, while Status calls ask for information about the device. 


An application wishing to access a CD-ROM drive should first issue an Open call to 
the driver. The Device Manager will return the reference number corresponding to the 
first CD-ROM drive which the INIT routine located. at startup If the application next 
makes a WhoIsThere stams call, the driver will report back the SCSI id's of any other 
drives. The related reference numbers can then be calculated and used in subsequent 
Device and File Manager calls. 


What makes the AppleCD SC work? 


The AppleCD SC device driver will not execute a Close request, except to return a 
CloseErr return code. This is done to prevent closing any other mounted volumes. 
There are only two ways to close the driver: either remove the AppleCD file from the 
system Folder and power-down all the CD-ROM drives attached to the SCSI bus, or 
restart the Macintosh. 


After a volume's reference number has been determined, data may be read from the 
disc using either the high-level FSRead routine or the low-level PBRead driver 
call. 


In addition, there are both high- and low-level calls that send control information to 
the device (Control and PBControl), as well as corresponding calls to retrieve 
status information (Statu 3 and PBStatus). 


Individual Control and Status calls that the driver recognizes are described later in the 
AppleCD SC control and status calls section. 


Disc insert event monitoring 


The Macintosh video circuitry generates a vertical blanking interrupt sixty times a 
second when the electron beam in the monitor tube moves from the bottom to the top 
of the display. This regular interrupt is the Macintosh heartbeat and can be used to 
trigger the regular occurrence of a user-defined procedure. An application initiates 
this activity by building a VBLTask record describing both the procedure and how 
often to execute it, and installs this record in the VBLQueue. Then, every 1/60th of a 
second (or tick), if the requested elapsed time has elapsed, the user procedure will get 
control. As previously mentioned, the Open routine installs such a VBLTask (the 
Task) to monitor CD-ROM disc inserting and ejecting. 


Two arrays of boolean flags indexed by SCSI id are initialized by the Open routine 
and maintained by the Task. The first of these indicates whether or not a CD-ROM 
drive is attached to a specific id. Obviously, if no CD-ROM drive is attached, the Task 
does no further processing with that id. 


The second array shows if a mountable disk was in the drive at the end of the last 
VBLtask execution. The success or failure of an attempt to communicate with an 
expected drive, combined with the mounted-last-time flag, yields a decision to 
mount, unmount or leave a drive as it is. Figure 2-3 presents the relationship between 
the flags in tabular format. 
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this time 
mounted SUCCESS FAILURE 
last time 
TRUE do nothing unmount disc 
FALSE mount new disc do nothing 
Figure 2-3 


Disc monitoring by the VBLTask logic 


Accessing the AppleCD SC driver from your 
application 


The current AppleCD SC driver installs itself when your system is booted up and is 
readily accessible by your application. To access the drive, your application needs 


only to open the driver, read data through the driver, and close the driver before your 
application terminates. 


‘> Note: All program examples in this section are written in the C programming 
language. 

To open the driver, use the Macintosh OS command that follows: 

OSErr = OpenDriver(".AppleCD", &refNum) ; 


* Note for non-C programmers: The notation &refNum in the command example 
above means "address of refNum." Additionally, the period (.) in the driver 
name is correct and significant. 


If the call is successful (OSErr equals noErr), the short integer refNum will contain the 


reference number for the driver. This number must be used in succeeding calls to read 
the CD-ROM. 


Using the AppleCD SC driver 


The driver offers two ways to read sequential blocks of data from a CD-ROM drive: 
Macintosh OS routines and SCSI commands. SCSI commands are issued to the drive 
directly by the application with SCSI calls, and allow several operations in addition to 
reading blocks of data. 
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Macintosh OS routines 


CD-ROM data can be read using the command listed below or through the lower-level 
File Manager calls described later. 


OSErr * FSRead(refNum, count, &buffPtr) ; 


where refNum is the driver reference number, count is the (long) integer number of 
bytes to read, and buffPtr is a pointer to the location where the bytes are 
deposited. FSRead is a sequential read starting where the last operation left off. The 
File Manager call SetFPos may be used to change this position. (SetFPos sets the 
mark of the open file, whose access path is specified by refNum, to the position 
specified by posMode and pos0Off.) 


Standard Macintosh result codes are negative integers or zero (zero meaning “no 
error’). If OSErr = -36, then an I/O error was encountered. If this code is returned 
during a disk read, execute a Status call, as indicated below: 


OSErr = Status (refnum, csCode, &csParam) ; 


where refnum is the value which was returned by the OpenDriver call, csCode 
should equal 99, and csParam is a 22-byte record, which contain the sense-bytes 
describing the error condition which occurred. (For a description of the error codes 
returned by the driver, see Chapter 8, “AppleCD SC SCSI Commands’. For 
information about the sense-bytes, see the technical documentation for the CD-ROM 
drive you are using.) 


The low-level routine PBStatus can also be used to obtain sense bytes. 


Macintosh OS Device Manager routines 


Your development environment may require you to use low-level Device Manager 
routines. These routines function like the related routines presented above, but 
require the construction of an I/O parameter block before executing thie call. More 
information is available in both the “File Manager” and “Device Manager” chapters of 
Inside Macintosh, Volume II. 


The Macintosh SCSI Manager offers two different commands for reading data from the 
AppleCD SC, SCSIRead and SCSIRBlind. The only difference between these two 
commands is the “handshaking” method used between the Macintosh and the CD- 
ROM drive. During a SCSIRead operation, handshaking occurs after each byte is 
transferred. When the SCSIRBlind command is executing, handshaking takes 
place only for the first byte of each block of data transferred. 


The following tells the AppleCD SC driver which read command to use 


OSErr = Control (refNum, csCode, &csParam) ; 


where refNum is the value returned by the OpenDriver call, csCode should equal 
78, and csParam is an integer Boolean variable which will be TRUE for 
SCSIRBlind or FALSE for SCSIRead reads. 
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Using the AppleCD SC SCSI routines 


If you need to exercise more control over your drive than the Macintosh OS routines 
offer, your application will need to execute SCSI commands directly to the drive. To 


use the AppleCD SC SCSI commands effectively, you should be familiar with the 
following documents: 


O ANSI X3T9.2 Committee SCSI Specification, Revision 17b 
© Inside Macintosh, Volume IV, Chapter 13, “The SCSI Manager” 
O The AppleCD SC SCSI commands described in Chapter 8 of this document 


* Note: You will still open the driver using the Macintosh OS routine described 
earlier in this document 


The basic Macintosh OS Control routine used to pass SCSI commands through the 
SCSI Manager to the CD-ROM drive is given below: 


OSErr = Control (refNum, csCode, &csParam) ; 


where csCode must equal 77. This code tells the device driver to build and execute a 
SCSI command based on the data to follow. csParam is a block of data with the 
following structure: 


struct csParam { /* csParam structure */ 

char *cspComBlkAddr; /* Address of SCSI command Block */ 

char *cspPProgAddr; /* Address of pseudo-program or NIL 
if no transfer */ 

char *cspBufAddr; /* buffer address for transfer or 
NIL if no transfer */ 

long cspTransSize; /* Size of transfer in bytes or NIL 
if no transfer */ 

long cspTicks; /* Ticks to wait until completion */ 

char cspComBlkSize; /* Size of the command block that we 


are sending */ 
} 


* Note: The signed value of the cspTransSize (size of transfer in bytes) field 
indicates the direction of data transfer, as listed in Table 1. _ 


Table | 
Description of the signed value in the cspTranssize field 


Sign Description of signed vaiue 


(0) no bytes are being transferred 
(+) reading data 


(-) writing data to the drive (actually writing parameters to the controller) 
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AppleCbD SC driver control and status calls 


Control calls send information to the device driver, while Status calls request 
information from the driver. 


The high-level Control and Status calls have a similar format. Each requires three 
parameters: first, refnum is the driver reference number returned by the Open call. 
Next, csCode tells the driver what type of information is being sent or requested, 
and last, csParamPtr points to the information itself. The format of the calls is: 


OSErr TheCall (refnum, csCode,csParamPtr) 
int refnum, csCode; 
char *csParamPtr; 


where TheCall is either a Control or Status call. It can also be seen that both calls 
return a result code, OSErr, to the calling routine. 


If the application programmer chooses, low-level Control and Status routines can be 
used as well. With low-level calls, the routine parameters to be passed to the driver are 
contained in a parameter block. The format of the parameter block is well-defined in 
Inside Macintosh and will not be repeated here. The variables passed in the high-level 
calls are placed in the parameter block before the low-level call is executed. The low- 
level call format is: 


OSErr ThePBCall (paramBlkPtr, asynch) 
char *paramBlkPtr; 
int asynch; 


where PBCallName is either PBControl or PBStatus, paramBlock points to the parameter 


block, and asynch is always FALSE. 


The high-level calls can be used when there is only one-way transfer of information as a result of the call. 
Others, like ReadTOC for example, function both like a Control call and like a Status call. That is 
control information is passed to the drive in the csParam area, and status information is found by the 
caller in the same data area after the call has completed. High-level Control and Status calls cannot be 


used for these calls; low-level Control and Status routines must be used instead. 
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Control calls 


The list of Control and Status calls are presented in the following format 


Call Name (csCode) 


Description: 
Input: 


Output: 


return codes: 


Verify (S) 


Description: 


Inputs: 


return codes: 


Format (6) 


Description: 


Inputs: 


return codes: 


Eject (7) 


Description: 


Inputs: 


a brief statement of the purpose or function of the call. 
a list of the contents of csParam passed to the call if any. 
a list of the contents of csParam returned by the call if any. 


all codes which could be returned by the call. 


The control call Verify reads each block, looking for non- 


readable blocks. Not used in the CD-ROM driver. The driver will 


return NoErr. 

none 

NoErr No error 
badUnitErr Bad reference number 


unitEmptyErr Bad reference number 
notOpenErr Driver is not open 


The control call Format prepares device media for data 
storage. CD-ROM discs are read-only so this call will return an 
error. 


none 


badUnitErr Bad reference number 
unitEmptyErr Bad reference number 

notOpenErr Driver is not open 

controlErr Driver can't respond to this Control call 


The control call Eject causes the AppleCD SC drive to eject 
the disc. Only supported by Apple and Toshiba drives. If the 
driver is controlling a Philips drive, NoErr will be returned. 


none 


return codes: 


Mediaicon (21) 


Description: 


Inputs: 
Outputs: 


return codes: 


Drivelcon (22) 
Description: 


Inputs: 
Outputs: 


return codes: 


Driveinfo (23) 
Description: 


Inputs: 


Outputs: 


return codes: 


NoErr No error 
badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr Driver is not open 


The control call MediaIcon returns a pointer to an icon list 
and a name string to caller. 


none 


csParam +0 pointer to icon list and name string 
NoErr No error 

badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr Driver is not open 


The control call DriveIcon returns a pointer to an icon list 
and a name string to caller. 


none 


csParam +0 pointer to icon list and name string 
NoErr No error 

badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr Driver is not open 


The control call DriveInfo returns about drive's physical 
location, size, and other characteristics to caller. See Inside 
Macintosh, Volume V. 


none 

csParam +0 byte0: $1 indicating “unspecified drive" 
byte 1: 14 indicating secondary drive, 
removable, SCSI, external. 

NoErr No error 

badUnitErr Bad reference number 


unitEmptyErr Bad reference number 
notOpenErr Driver is not open 
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SCSI (77) 


Description: 


Inputs: 


return codes: 


RSwiteh (78) 
Description: 


Inputs: 


return codes: 


VarBik (79) 


Description: 


Inputs: 


return codes: 


The control call SCSI lets an application send a SCSI command 
directly to the CD-ROM drive. Ifan ioErr error is returned, 
execute a GetSense Staws call (given later) to retrieve sense 
bytes returned to driver from drive. 


csParam +0 address of SCSI command string 

csParam +4 address of Transfer Instruction block or NIL 

csParam +8 reserved (4 bytes of 0) 

csParam +12 an integer value; 1 = read and -1 = write 

csParam +14 reserved (2 bytes of 0) 

csParam +16 number of ticks (1/60 sec) to wait before 
completion phase is started 

csParam +20 length of SCSI command string (word) 


NoErr No error 
badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr Driver is not open 
ioErr Input/Output error 


The control call RSwitch lets an application specify whether 
polling for new data on the SCSI bus will occur only at the 
beginning of blocks, or for each byte during read commands. 


esParam+0 TRUE # polling on each block 
FALSE = polling on each byte 


NoErr No error 
badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr Driver is not open 


Each of the CD-ROM drives controlled by this driver support 
variable block sizes. The control call VarBlk sets the device 
block size. 


csParam+0 the blocksize (integer). Legal blocksizes in bytes 
are 512, 256, 1024, 2048, 2336, and 2340 for the 
AppleCD SC and Toshiba drives. The Philips 
sizes are the same except for 2340 bytes; on the 
Philips CM 110 drive this becomes 2352 bytes. 


NoErr No error 
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badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr Driver is not open 
paramErr invalid blocksize parameter 


UserEject (80) 


Description: The control call UserEject enables or disables the eject 
button on the drive, as well as the SCSI Eject command. Valid 
only on the AppleCD SC and Toshiba drives. If used with Philips 
drive, driver will return controlErr. 


Inputs: csParam +0  wordsized 
1: enables button eject (default) 
2: disables button eject 


Outputs: | none 


return codes: NoErr No error 
badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr Driver is not open 
controlErr Driver cannot respond to this call 


VBLFrequency (81) ( 


Description: The control call VBLFrequency permits the user to control 
how often the "disk in place" VBLtask is executed. Probably 


most useful when debugging. 
Inputs: csParam +0 number of ticks (word) 
Outputs: none 
return codes: NoErr No error 


badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr Driver is not open 


ReadTOC (100) 
Description: Read Table of Contents, ReadTOC, returns table-of -contents 
information depending on the type of request. 
Inputs: csParam +0 type of ReadTOC call (word-sized): 


1: return first and last user track number in BCD. 

2: return address of Lead Out area in BCD 
Min-Sec-Frame. 

3: return starting addresses for user-specified 
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range of tracks. 


For type#1 and type#2 calls, the data will be returned directly in 
the csParam field. With type#3 calls, the user must allocate 
space for the data which the drive will return. 


The following parameters are also required for type#3 calls: 


esParam +2 Address of data buffer Jong word) 
csParam +6 Length of data buffer (word) 
csParam +8 starting track number (byte) 


The number of tracks for which information is requested will be 
calculated from the length of the allocated space. 


Outputs: For type #1 calls: csParam +0 first user track number in BCD 
csParam +1 last user track number in BCD 
csParam +2 0 
csParam +3 0 


For type #2 calls: csParam +0  Lead-out starting area address 


in BCD (MIN) 

csParam +1  Lead-out starting area address 
in BCD (SEC) 

csParam +2 Lead-out starting area address 
in BCD (FRAME) 


csParam +3 0 


For type #3 calls: Four bytes of data will be returned in the user- 
specified buffer for each track in the following 


format: 
byte: content: 
0 control field of specified track 
al track start MIN in BCD 
2 track start SEC in BCD 
3 track start FRAME in BCD 
return codes: NoErr No error 
badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr Driver is not open 
paramErr bad parameter error 
controlErr Driver can't respond to this Control call 


Read@ (101) 


Description: The control call ReadQ retums the current Q Subcode address 
data in csParam 
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Inputs: 


Outputs: 


return codes: 


ReadHead (102) 
Description: 


Inputs: 


Outputs: 


return codes: 


ATrkSearch (103) 
Description: 


Inputs: 
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none 


csParam 
csParam 
csParam 
csParam 
csParam 
csParam 
csParam 
csParam 
csParam 


NoErr 


badUnitErr 
unitEmptyErr 
notOpenErr 
paramErr 
controlErr 


+0 
+1 
+2 
+3 
+4 
+5 
+6 
+7 


+8 | 


control 

track number 
index 

MIN 

SEC 

FRAME 
AMIN 

ASEC 
AFRAME 


No error 

Bad reference number 

Bad reference number 

Driver is not open 

bad parameter error 

Driver can't respond to this Control call 


The control call ReadHeader returns absolute address and 
mode information about a specific logical block. This call is valid 
only for blocks in data tracks. If a requested block is in an CD- 
Audio (Red book) section of the disc, an error will be returned. 


csParam 


csParam 
csParam 
csParam 
csParam 


NoErr 


badUnitErr 
unitEmptyErr 
notOQpenErr 
paramErr 
controlErr 


+0 


+0 
+1 
+2 
+3 


logical block number (word) 


absolute time AMIN 
absolute time ASEC 
absolute time AFRAME 
MODE 


No error 

Bad reference number 

Bad reference number 

Driver is not open 

bad parameter error 

Driver can't respond to this Control call 


The control call ATrkSearch positions the optical pickup at 
the specified audio address. An paramErr error will be returned if 
the address is not in an audio area of the disc. 


csParam 


+0 


Address type (word): 
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O: search address in logical block format. 

1: search address in AMIN, ASEC, 
AFRAME format. 

2: search address in TNO format. 


csParam +2 Search Address (ong word): 
from MSB in byte 2 to LSB in byte 5 
csParam +6 Play Flag (word): 7 
7 O = search and pause at address. 
non-0 = play according to play mode. 
csParam +8 Play Mode (word): 


lower four bits make up mnemonic for 
play mode. The right two bits (0 and 1) 
stand for*speaker right channel output 
from left and right channel! input; the 
left two bits (2 and 3) stand for speaker 
left channel output from left and right 
channel input; such as, 

0000B Muting 

0001B = Rthru R only 

0011B L/Rthru Ronly 

1001B LthruL, R thru R (stereo) 


Outputs: none 
return codes: NoErr No error 
| badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr Driver is not open 
paramErr bad parameter error 
controlErr Driver can't respond to this Control call 
APlay (104) 


Description: The control call APlay positions optical pickup at specified 
audio address and begins playback in specified play mode when 
address is found. Error is returned if address is not in audio area 
of disc. 


Inputs: ° csParam +0 Address type (word): 
0: search address in logical block 
format. 
1: search address in AMIN, ASEC, 
AFRAME format 
2: search address in TNO format. 
csParam +2 Search Address (ong word): 
from MSB in byte 2 to LSB in byte 5 
csParam +6 ~~ = StopAddress Flag (word): 
0 = the Playback Address is a starting 
address. In this case, the stop address 


return codes: 


APause (105) 
Description: 


Inputs: 


Outputs: 


return codes: 


AStop (106) 


Description: 


csParam +8 


NoErr 
badUnitErr 
unitEmptyErr 
notOpenErr 
paramErr 
controlErr 


should have been set by a prior Audio 

Stop command. © 

non-0 = the Playback Address is a 

stopping address. Here, the starting 

address is set by an earlier Audio 

_ Search command with Play flag = 0. 

Play Mode (word): 

lower four bits make up mnemonic for 

play mode. The right two bits (0 and 

1)stand for speaker right channel output 

from left and right channel input, the 

left two bits (2 and 3) stand for speaker 

left channel output from left and right 

channel input, such as, 

0000B Muting 

0001B R thru R only 

0011B L/R thru R only 

1001B L thru L, R thru R (stereo) 


No error 

Bad reference number 

Bad reference number 

Driver is not open 

bad parameter error 

Driver can't respond to this Control call 


The control call APause starts or stops current audio play 


operation. 


csParam +0 


none 


NoErr 
badUnitErr 
unitEmptyErr 
notOpenErr 
paramErr 
controlErr 


long word 

1 = enter hold state and mute audio 

0 = release pause and resume play at next 
block 


No error 

Bad reference number 

Bad reference number 

Driver is not open 

bad parameter error 

Driver can't respond to this Control call 


The control call AStop specifies audio address at which audio 


play will stop. 


2-18 Chapter 2: AppieCD SC Software (Alpha draft) 


Inputs: csParam +0 Address format (word): 


0 = logical block address 
1 = minute-second-frame address 
2 = track number address 
csParam +2 Address (long word) 
Outputs: none 
return codes: NoErr No error 
badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr Driver is not open 
paramErr bad parameter error 
controlErr Driver can't respond to this Control call 
AStatus (107) 


Description: The control call AStatus returns status data of current audio 
block. If drive is not in "ready" condition, ioErr error will be 
returned. The application may then call GetSense to request 
sense bytes describing problem. If AStatus is called while the 
drive is reading a data block, ioErr will be returned. 


Inputs: none 


Outputs: csParam +0 Audio Status byte: 
0 = audio play in progress 
1 = audio pause in operation 
2 = audio muting on 
3 = audio play operation completed 
csParam +1 Play Mode: 
0 = play with muting on : 
1 = play right chan thnu right chan only 
2 = play left chan thru right chan only 
3, = play |/r chan thru right chan only 
4 = play right chan thru left chan only 
S = play right chan thru left and right 
6 = play r chan thru left, left chan thru right 
7 = play r chan thru |, I/r thru r chan 
8 = play | thru | only 
9 = play | thru | chan, r thru r chan (stereo) 
10 = play | thru], r thru | 
11 = play | thru |, I/r thru r 
12 = play |/r thru | 
13 = play Ir thru |, r thru r 
14 = play I/r thru |, | thru rr 
15 = play L/r thru 1, Lr thru r (mono) 
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csParam +2 Control field of next track: 
bits 
3210 = function 
00x0 2 audio chan without pre-emphasis 
00x1 2 audio chan with pre-emphasis 
10x0 4 audio chan without pre-emphasis 
10x14 audio chan with pre-emphasis 
Olxl data track 
Olxl reserved 
llxx reserved 
xx0x digital copy prohibited 
xxlx digital copy permitted 


esParam +3 next track starting address (AMIN) 

csParam +4 next track starting address (ASEC) 

csParam +5 next track starting address (AFRAME) 
return codes: NoErr No error 

badUnitErr Bad reference number 

unitEmptyErr Bad reference number 

notOpenErr Driver is not open 

paramErr bad parameter error 

controlErr Driver can't respond to this Control call 


ASean (108) 


Description: The contro! call AScan will perform a fast-forward or fast- 
reverse scan operation starting from specified address. 


Inputs: csParam +0 Address type (word): 
0: search address in logical block 
format. 
1; search address in AMIN, ASEC, 
AFRAME format. 
Z: search address in TNO format. 
csParam +2 Search Address (ong word): 
from MSB in byte 2 to LSB in byte 5 
Outputs: none 
return codes: NoErr No error 
badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr Driver is not open 
paramErr bad parameter error 
controlErr Driver can't respond to this Control call 
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Status calls 


DiskStatus (8) 

Description: The DiskStatus call is used by the system to learn various 
attributes about the mounted disc. 

Inputs: none 

Outputs: csParam +0 track 0 
csParam +2 WriteProtect 128 
csParam +3 diskInPlace 1=yes 0=no 
csParam +4 installed 1 
csParam +5 sides 1 
csParam +6 qLink NIL 
csParam +10 qType 0 
esParam +12 dQDrive drive number 
csParam +14 dQRefNum drive reference number 
csParam +16 dQFSID 1 
csParam +18 twoSideFmt 0 
csParam +19 needsFlush 0 
csParam +20 diskErrs 0 

return codes: NoErr No error 
badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr Driver is not open 


WholsThere (97) 


Description: WhoIsThere lets an application know what SCSI ids have CD- 
ROM drives assigned. 


Inputs: none 
Outputs: csParam +0 0 
csParam +1 bits 0 thru 7 correspond to SCSI ids 0 thru 7. 
If a bit equals 1, the corresponding SCSI id 
has a CD-ROM drive assigned to it. 
return codes: NoErr No error 
badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr Driver is not open 
GetSize (98) 
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Description: GetSize returns the currently assigned logical block size. 


Inputs: none 

Outputs: esParam +0 _ block size (word) 

return codes: NoErr No error 
badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr Driver is not open 

GetSense (99) 
Description: GetSense returns current sense bytes to calling application. 


Number of bytes returned depends on drive used. For the 
AppleCD SC and Toshiba drive, 18 bytes should be expected. For 
Philips, 4 bytes will be returned. Calling application should make 
this call after receiving ioErr retum code. 


Inputs: none 

Outputs: csParam +0 4 to 18 bytes of sense data 

return codes: NoErr No error 
badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr Driver is not open 


Apple II AppleCD SC SmartPort control call 
descriptions 


This section provides the AppleCD SC control call descriptions. Note that the 
parameter list format for the AppleCD SC control calls is the same as described in the 
Firmware command definitions section of the Apple I! SCSI Card Technical 
Reference Manual unless otherwise defined in the control call descriptions. 


* Note: To fully understand and implement the AppleCD SC control calls described 
in this section, you need to refer to the description of the Apple II SCSI Card 
SmartPort firmware provided in the Appiell SCSI Card Technical Reference — 
Manual. 


Table 2-1 shows the control codes and their associated routine or SCSI command, with 
the SCSI operation code Cif any) given in parenthesis. 


Table 2-1 
Control codes 
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ere 


Code Definition 

$04 Eject ($CO) 

$05 TestUnitReady ($00) 
$06 RequestSense ($03) 
$08 ModeSelect ($15) 
$09 ModeSense ($1A) 
$0D ReadCapacity ($25) 
$OE SendDiagnostic ($1D) 
$OF Inquiry ($12) 

$13 SetBlockSize 

$14 SetTimeout 

$16 ExtendedSeek ($2B) 
$17 ReceiveDiagnostic ($1C) 
$18 StartUnit ($1B) 

$19 StopUnit ($1B) 

$1A PreventRemoval ($1E) 
$1B AllowRemoval ($1E) 
$1C Verify ($2F) 

$1D RezeroUnit ($01) 

$1E Patch1Call 

$1F SetNewSDAT 

$20 AudioSearch ($C8) 
$21 AudioPlay ($C9) 

$22 AudioPause ($CA) 
$23 AudioStop ($CB) 

$24 AudioStatus ($CC) 
$25 AudioScan ($CD) 
$26 Eject ($CO0) 

$27 ReadTOC ($C1) 

$28 ReadQSubcode ($C2) 
$29 ReadHeader ($C3) 
$2A Setinterleave ($04) 
Eject ($04) 


Description: The SmartPort Eject control code executes the SCSI Eject 


($C0) command. The parameter list for this control code is as 


follows: 

Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 reserved ($00) 

4 control code ($04) 
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TestUnitReady ($05) 
Description: The TestUnitReady SmartPort control code executes SCSI 


Test Unit Ready ($00) command. The parameter list for 
this control code is as follows: 


Byte Definition 

) parameter list length ($03) 
1 unit number 

2-3 reserved ($00) 

4 control code ($05) 


RequestSense ($06) 
Description: The RequestSense SmartPort control code executes the SCSI 


Request Sense ($03) command. The parameter list for this 
control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 buffer pointer (isb—msb) 

4 control code ($06) 


ModeSelect ($08) 
Description: The ModeSelect SmartPort control code executes the SCSI 


Mode Select ($15) command. The parameter list for this 
control code is as follows: 


Byte Definition 

0 parameter list length ($04) 
1 unit number 

2-3 buffer pointer (dsb—msb) 

4 control code ($08) 

e, transfer byte count 


ModeSense ($09) 
Description: The ModeSense SmartPort control code executes the SCSI 
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Mode Sense ($1A) command. The parameter list for this 
control code is as follows: 


Byte Definition 

0 parameter list length ($04) 
1 unit n 

2-3 buffer pointer (sb—msb) 

4 control code ($09) 

5 transfer byte count 
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ReadCapacity ($0D) 


Description: 


The ReadCapicity SmartPort control code executes the SCSI 


Read Capacity ($25) command. The parameter list for this 
control code is as follows: 


Byte Definition 

0) parameter list length ($03) 
1 unit number 

2-5 buffer pointer dsb—msb) 

6 control code ($0D) 


SendDiagnostic ($0E) 


Description: 


Inquiry (SOF) 
Description: 


SetBlockSize ($13) 
Description: 


The ReadDiagnostic (S0OE) SmartPort control code 
executes the AppleCD SC SCSI Send Diagnostic ($1D) 
command, The parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 reserved 

4 control code ($0E) 


The Inquiry ($0F) SmartPort control code executes the 


AppleCD SC SCSI Inquiry ($12) command. The parameter 
list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 buffer pointer (sb—msb) 

4 control code ($0E) 


The SetBlockSize ($13) SmartPort control code sets the 
number of bytes per block on the AppleCD SC. The parameter list 
for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 block size (bytes) msb-lsb 
4 control code ($13) 
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SetTimeout ($14) 


Description: The SetTimeOut ($14) SmartPort control code sets the 
amount of time the initiator will wait for a response from the target 
before terminating the command (timeout). The timeout 
constant ranges from $00-SFF, and is loaded into the Control 
call parameter list in byte 2. For this command, byte 3 of the 
parameter list must be set to 0. The default timeout constant is 
$08, for a timeout duration of approximately 10 seconds. The 
parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2 timeout 

2 reserved ($00) 

4 control code ($14) 


Seek ($16) 


Description: The Seek ($16) SmartPort control code executes the Apple 
CD SC SCSI Extended Seek ($2B) command. The 
parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) "a , 
I unit number 
2-5 seek address buffer pointer 

6 control code ($16) 


ReceiveDiagnostic ($17) 


Description: The ReceivedDiagnostic ($17) SmartPort control code 
executes the AppleCD SC SCSI Receive Diagnostic 


Results ($1C) command. The parameter list for this control 
code is as follows: 


Byte Definition 

0) parameter list length ($03) 
1 unit number 

2-3 buffer pointer (sb—msb) 

4 control code ($17) 
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StartUnit/StopUnit ($ 18/$19) 


Description: These codes execute the AppleCD SC SCSI Start/Stop Unit 
($1B) command. Each must be used separately; StartUnit 
($18) only starts the unit, while StopUnit ($19) only stops 
it. The parameter list for these control codes is as follows: _ 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 reserved ($00) 

4 control code ($18/$19) 


PreventRemoval/AllowRemoval ($1A/$ 1B) 


Description: These codes execute the AppleCD SC SCSI Prevent /Allow 
Removal ($1E) command. Each must be used separately. The 
parameter list for these control codes is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 reserved ($00) 

4 control code ($1A/$1B) 


Verify ($1C) 


Description: The verify ($1C) SmartPort control code executes the SCSI 


Verify ($2F) command. The parameter list for this control 
code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-5 reserved ($00) 

6 control code ($1C) 


RezeroUnit ($ 1D) 


Description: The RezeroUnit ($1D) SmartPort control code executes the 


SCSI Rezero Unit ($01) command. The parameter list for 
this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 reserved ($00) 

4 control code ($1D) 
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Patch! Call ($1E) 


Description: This code is used to patch one unsupported command to the 
command interpreter. It executes program code loaded into RAM 
bank 2 at $C803. To use this call, you must write the p 
code, exactly as you want it to execute, into bank 2 RAM starting at 
$C803. Once you have loaded the program code, executing 
PatchiCall will automatically execute your command. 


Important 


Remember thot your command Is loaded in RAM: any reinifialization or loss of 
power will erase it. 


The parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
| reserved ($00) 

2-3 reserved ($00) 

4 control code ($1E) 


SetNewSDAT ($1F) 


Description: This code forces the SCSI card to reinitialize the SDAT and 
DIBTAB device tables for all devices resident on the SCSI bus. 
The parameter list for this control code is as follows: 


Byte Definition 
parameter list length ($03) 
1 unit number (any valid unit number will work) 
2-3 RAM address pointer 
4 control code ($1E) 


AudioSearch ($20) 


Description: The AudioSearch ($20) SmartPort control code executes 
the AppleCD SC SCSI Audio Track Search (SC8) 
command. The parameter list for this control code is as follows: 


Byte Definition 

) parameter list length ($03) 
1 unit number 

2-5 buffer pointer 

6 control code ($20) 
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AudioPlay ($21) 


Description: 


AudioPause ($22) 


Description: 


The buffer contains the control parameters required by the SCSI 
command for proper execution, as follows: 


Byte Definition 

0 play flag (O=hold after search, 1=play after search) 
1 play mode ($00-SFF) 

2-5 search address (lsb-msb) 

6 type ($00-$02) 


The AudioPlay ($21) SmartPort control code executes the 
AppleCD SC SCSI Audio Play ($C9) command. The 
parameter list for this control code is as follows: 


Byte Definition 

0) parameter list length ($03) 
1 unit number 

2-5 buffer pointer (sb—msb) 
6 control code ($21) 


The buffer contains the control parameters required by the SCSI 
command for proper execution, as follows: 


Byte Definition 

0 stop flag (O=stop address in 2-5, 1=play address) 
1 play mode ($00-$SFF) 

2-5 playback address (sb—msb) 

6 type ($00-$02) 


The AudioPause ($22) SmartPort control code executes the 
AppleCD SC SCSI Audio Pause (SCA) command. The 
parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
i unit number 

2-5 buffer pointer (sb—msb) 
6 control code ($22) 


The buffer contains the control parameters required by the SCSI 
command for proper execution, as follows: 


Byte Definition 
0 pause flag (0=pause, 1=resume) 


Apple Il AppleCD SC SmartPort control call descriptions 


2-29 


AudioStop ($23) 


- Description: The AudioStop ($23) SmartPort control code executes the 
AppleCD SC SCSI Audio Stop ($CB) command. The 
parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-5 buffer pointer (sb~msb) 

6 control code ($23) 


The buffer contains the control parameters required by the SCSI 
command for proper execution, as follows: 


Byte Definition 
Q—3 stop address (msb~isb) 
4 type ($00-$02) 


AudioStatus ($24) 


Description: The AudioStatus ($24) SmartPort control code executes 
the AppleCD SC SCSI Audio Status (SCC) command. The 
parameter list for this control code is as follows: 


Byte Definition ( | 
0 parameter list length ($03) 
1 unit number 

2-5 buffer pointer (sb-msb) 

6 control code ($24) 


AudioSean ($25) 


Description: The AudioScan ($25) SmartPort control code executes the 
AppleCD SC SCSI Audio Scan ($CD) command. The 
parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-5 buffer pointer (sb—msb) 

6 control code ($25) 


The buffer contains the control parameters required by the SCSI 
command for proper execution, as follows: 


Byte Definition 

0 direction flag (0=forward, 1=reverse) 
1 reserved ($00) 

2-5 scan start address (sb-msb) 

6 type ($00-$02) 
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ReadTOC ($27) 
Description: 


The ReadTOC ($27) SmartPort control code executes the 
AppleCD SC SCSI Read Table of Contents ($C1) 
command. The parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 buffer pointer (isb~msb) 

4 control code ($27) 


The buffer contains the control parameters required by the SCSI 
command for proper execution, as follows: 


Byte Definition 

0 track number 

1-2 allocation length (sb—msb) 
5 type ($00~$02) 


ReadQ@Subcode ($28) 


Description: 


The ReadQSubcode ($28) SmartPort control code executes 


the AppleCD SC SCSI Read Q Subcode ($C2) command. 
The parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 buffer pointer (sb—msb) 
4 control code ($28) 


ReadHeader ($29) 


Description: 


The ReadHeader ($29) SmartPort control code executes the 
AppleCD SC SCSI Read Header ($C3) command. The 
parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 buffer pointer dsb—msb) 

4 control code ($29) 


The buffer contains the control parameters required by the SCSI 
command for proper execution, as follows: 


Byte Definition 
0-3 block address 
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Be 


Chapter 3 


High Sierra and 
AppleCD $C 


This chapter includes a brief overview of the High Sierra file system and how High 
Sierra presents files to the Macintosh or Apple IIGS user. 


The High Sierra file system 


High Sierra is a standard that specifies a hierarchical volume and file structure for CD- 
ROMs. The purpose for High Sierra is to provide a CD-ROM file structure that is not 
dependent on a particular operating system. The High Sierra file system allows for the 
interchange of information between any number of computer operating systems that 
are configured to recognize and translate the High Sierra structure. 


Three similar formats exist, they are the May 28, 1986, Working Paper for 
Information Processing— Volume and File Structure of Compact Read Only Optical 
Discs for Information Interchange (commonly referred to as High Sierra) published 
by the CDROM Ad Hoc Advisory Committee, the purposed ISO 9660 ISO 
Cnternational Standards Organization) Standard, and the European Computer 
Manufacturers Association ECMA-119 Standard. 


The complete specification for the High Sierra, ISO, or ECMA standard will not be 
repeated in this document If you plan to develop your CD-ROM product in one of 
these formats, you will need to reference the appropriate specifications for 
compaubility testing. 


* Note: In May of 1982, a group of computer technology experts from Apple, DEC, 
Sony, and other leaders in the computer industry (referred to as the Ad Hoc 
Committee), gathered at Del Webb’s High Sierra Casino in Stateline Nevada. 
Their purpose was to write a paper that described a file and volume structure for 
CD-ROM that could be universally read from any computer operating system. 
Hence, the name “High Sierra” was selected for the file format.. 


High Sierra on the Macintosh and Apple Il 


CD-ROMs developed with the High Sierra May 86 or ISO 9660 file structures will be 
recognized by future releases of the Macintosh and Apple IIGS computer operating 
systems. The Macintosh and Apple IIGS systems will provide a transparent application 
interface to High Sierra structured CD-ROMs. The interfaces will allow access to High 
Sierra files through standard Macintosh or Apple IIGS system calls. 


The High Sierra file system translation software in the Macintosh and Apple IGS 
systems will support single High Sierra volumes on a CD-ROM. The High Sierra 
volumes can be of any size, as long as only one volume exists on the disc. Other 
implementation specific details for the Macintosh and Apple Igs High Sierra file 
system transiators will be released in a future revision of this document. 
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High Sierra on the Macintosh and Apple Ilcs deskiop 


High Sierra files and directories on High Sierra discs will appear on the desktop with 
the standard default file and folder icons. You will be able to display files and folders 
in each of the modes available from the View menu. The View menu modes are: by 
Icon, by Name, by Date, by Size, and by Kind. More information about the user 
interface and implementation-specific details for High Sierra on Macintosh and 
Apple IIGS computers will be included in a future release of this document. 


High Sierra on Apple Ils 


Apple 0 computers, other than the Apple IGS, will have a set of High Sierra utility 
routines, which will allow applications to read High Sierra CD-ROMs. The Appie I 
High Sierra utility routines must be specifically called by the application. More 
information-specific details for High Sierra on the Apple II will be included in a furure 
release of this document. 
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Why CD-ROM and HyperCard? 


Just as CD-ROM is an ideal method to distribute vast amounts of diverse data, 
HyperCard is an excellent way to organize and display this information. 


Perhaps the single most interesting advantage HyperCard offers you as a developer is 
the opportunity to present users with a consistent interface — something currently 
lacking in the CD-ROM world. And, because HyperCard is bundled with all of the 
Macintosh CPUs, it’s a interface familiar and available to a huge customer base. 


Another development advantage is HyperCard’s easily programmable graphic 
Macintosh interface—one that utilizes all of the toolbox routines. HyperCard allows 
you to construct your Macintosh interface more quickly than if you programmed it in 
Pascal or C. Hence, your software development time and cost will be reduced 
significantly. You will not have to spend a lot of time learning how to program the 
Macintosh from scratch. 


For example, if you choose to use HyperCard as an interface, you can put the majority 
of your effort into the content and functionality of your database. The user ends up 
with the familiar point and click environment rather than a series of complicated 
command lines and function keys.Best of all, HyperCard is flexible and extensible 
enough to let you do the things you do best 


In addition, your existing products can be inexpensively moved into the Macintosh- 
HyperCard environment in one of two ways: (1) by producing HyperCard stacks and 
using your talents and existing software to produce an innovative, easy-to-use retrieval 
engine for HyperCard or (2) by porting the internals of your product over to the 
Macintosh, then utilizing the HyperCard external command feature (described later) 
and graphic interface. 


Even without using HyperCard extensions or creating a new retrieval engine, 
HyperCard provides an excellant platform from which to publish on a CD-ROM. 
HyperCard stacks, which provide the user with buttons and easy to follow links to your 
data, can be put on CD-ROM. HyperCard then reads the stacks on the CD-ROM and 
presents your data to the user without any changes. _ 


Hypertalk: the HyperCard authoring language 

HyperTalk is the powerful and easy-to-use authoring language for HyperCard, 
providing the tools to build the visual and interactive retrieval models possible with 
HyperCard. It activates HyperCard, and is the glue you use to link the various parts of 
your stack together. HyperTalk allows you to control the actions of HyperCard objects: 
buttons, fields, cards, backgrounds, and stacks. 
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You use HyperTalk to send messages to and from HyperCard objects. A message can 
be generated by a click of the mouse, the opening of a card, a statement typed into the 
Message box, or other event. How a given object responds to a particular message 
depends on its script, and all HyperCard scripts are written in HyperTalk. 


* Note: HyperCard is not a classic object-oriented programming system, although it 
implements some object-oriented concepts, such as message passing and objects 
themselves. | 


This document provides a high level overview of HyperCard concepts. For a more 
comprehensive description of HyperCard and the HyperTalk language, see the 
HyperCard Script Language Guide, available from the Apple Programmer's and 
Developer's Association (APDA), and The Complete HyperCard Handbook, by 
Danny Goodman. | | 


HyperCard Objects 


There are five kinds of objects in HyperCard: buttons, fields, cards, backgrounds, 
and stacks. (Examples of HyperCard objects are shown in Figure 4-1.) The basic unit 
of information is the card: when you look at the screen of a Macintosh™ computer 
running HyperCard, what you see foremost is a card. Each card is associated with a 
background, and a background may be (and usually is) shared by more than one card. 
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This is the first card in the stack 


a yma GUIDE TO FLOWERING PLANTS _ 
7 . _ _— CLICK ON PICTURE TOMARE SELECTION _ 
SCTnTce _ 
SHAPE 
Buttons 


HyperCard objects 


The card overlays the background; both are the size of the card window, which is the 
size of the original Macintosh screen. What you see in the card window belongs to the 
card, or, if the card is transparent, to the background The card and background both 
contain pictures—the arrangement of pixels that define their appearance. Cards are 
grouped in stacks, which are Macintosh files. The layers of objects that make up what 
you see in HyperCard are shown in Figure 4-2.. 
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Background Shared Shared Card Card Card What 
Picture Fields Buttons Picture Fields Buttons You See 


The background and card pictures are in any order within the card or background 


in fixed positions. Other objects can be and can be transparent or opaque. 
Figure 4-2 ; 


The layers of HyperCard objects on cards and backgro 


Cards and backgrounds also contain buttons and fields. Buttons are action objects or 
“hot spots” on the screen—when you click a button with the Browse tool, something 
usually happens. For example, clicking a button can take you to the next card ina 
stack. Fields carry editable text: strings of characters. The Browse tool hand pointer 
changes to an I-beam when it’s positioned over a field of unlocked text, enabling you 
to manipulate the text with it. All editable text in HyperCard is carried in fields. (There 
may also be characters on the card or background which are Paint text Such 
characters are not editable once they are placed; they are part of the picture on the 
card or background.) 


When HyperCard is running, its environment of objects consists of one open (or 
visible) card, that card’s background, the buttons and fields belonging to the card and 
those belonging to the background, the stack they are all in, all the objects in other 
stacks on disks and servers connected to your Macintosh, and HyperCard itself. 
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* Note: HyperCard also keeps track of the rest of the Macintosh environment: other 
applications and their documents, I/O devices such as disk drives and modems, 
and so on, but HyperCard doesn't treat these entities as objects. Some HyperCard 
commands, such as Dial, Open, and Write, deal directly with the external 
environment, and you can extend HyperCard with your own external commands 
and functions. External commands and functions are described in the section, 
“HyperCard External Commands.” 


Messages 


HyperCard objects interact with each other, with the user, with HyperCard, and with 
the Macintosh environment, by sending messages. Some messages are descriptions of 
things that happen in the environment, such as that the mouse has been clicked or a 
card opened. These are system messages; flashes announced to the community of 
objects. For example, if you click the mouse button down, HyperCard generates the 
message mouseDown, and when you let the mouse button up, it generates the message 
mouseUp. Messages are sent to various objects in tum, depending on the position of 
the objects, the nature of the message, and other conditions. For example, mouse 
click messages go first to the topmost button or field (if any) under the pointer on the 
screen. Next the message goes to the card, the background, the stack, the Home stack, 
and finally to HyperCard itself. 


HyperTalk command statements are also messages—orders to do some particular 
thing, like add two numbers or go to another card. A command, whether executed in a 
script or typed into the Message box, is always sent as a message. 


Scripts 


How any object responds to a message depends on its script, and every HyperCard 
object has a script (although it can be completely empty). Each line of a script is a 
HyperTalk statement, defined by a carriage return at its end. The first word of a 
Statement is either a control word, such as on, which makes the statement a control 
Statement, or it’s a command, such as go, which makes the statement a command 
Statement Control statements determine how scripts execute, and command 
Statements are sent as messages to other objects in the HyperCard environment. The 
syntax of the rest of the statement following the first word depends on the particular 
control word or command. 


A script consists of any number of control structures called handlers. A simple 
handler looks like this: 


on mouseUp 
go to next card 
end mouseUp 
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This message handler is likely to be in the script of a button; it handles the message 
mouseUp. The message to which a handler responds begins with the word following 
the keyword on, which is the first word of every message handler. The entire first line, 
on mousewUp, is a control statement: it begins with a HyperTalk keyword, it controls 
the execution of part of the script, and it is not sent as a message. When you release the 
mouse button while the Browse tool is inside a button’s rectangle on the screen, 
HyperCard sends the message mouseUp to the button. HyperCard looks in the 
button’s script for a handler matching the mouseUp message. If it finds a match, it 
runs the handler—executes the HyperTalk statements between on mouseUp and 
end mouseUp. The second line of the handler, go to next card, is a command 
statement: it does not begin with a keyword, so it is sent as a message. 


In addition to message handlers, scripts can contain function handlers. Function 
handlers begin with the keyword function in place of the word on and have the 
name of the function they handle following the keyword. A function handler looks like 
this: 


function day 
return the first word of the long date 
end day 


This function handler responds to a HyperTalk statement containing the function’s 
name followed by parentheses—a function call: 


put day() into the message box 


When a function call is made, HyperTalk looks in the scripts of certain objects in the 
HyperCard environment for a matching function handler. If it finds one, it executes 
the lines between function day and end day. 


A script example 


The following message handlers, from the HyperCard Help stack, illustrate the basic 
syntax of a script. The first handler is in the script of the main Help stack: 


on openStack 

global HelpExit 

push recent card 

pop card into It 

if "help" is not in It then put It into HelpExit 
end openStack 


The second handler is in the script of the background button named “Exic’: 


A script example 
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on mouseUp 
global HelpExit 
visual effect dissolve 
go to HelpExit 

end mouseUp 


These two handlers work together to provide an easy exit from the Help systern which 
returns you to the card you were on before you entered Help. The first handler puts the 
identifier of the card you were on into a global variable; the second handler gets the 
value of that variable and takes you to the card it identifies. 


The first and last lines of each handler are control statements. Because the first line 
begins with on, they are message handlers. The last line indicates the end of the 
handler. The first handler responds to the system message openStack that 
HyperCard sends to the currently open card as soon as its stack is opened. The second 
handler responds to the system message mouseUp that HyperCard sends to the 
°Exit” button when you click it 


The first three indented lines within the openStack handler, 


global HelpExit 
push recent card 
pop card into It 


are direct command statements; the first word of each is its command name. The 
command global declares a global variable, meaning that any handler can read its 
value (all HyperCard variables are local to their handler unless declared global); 
HelpExit is the variable name. The push recent card statement puts the 
identifier of the card you were on before you got to the current card into a last-in, first- 
out stack (an area of memory, not a HyperCard stack). The pop card into It 
statement copies that card identifier into a local variable called It. The next 
statement, 


if "help" is not in It then put It into HelpExit 


is a control statement containing a command statement. That is, the first word if is 
a keyword indicating a conditional section. The if is followed by an expression that 
evaluates to true or false, and that expression is followed by the keyword then. 
The rest of the statement is a command statement If the expression is true, the 
command is executed; if false, the command is not executed. The command put 
It into HelpExit copies the value of the local variable It into the global 
variable HelpExit. The effect of this statement is to set your exit destination to the 
card you came from only if you came from a stack whose name does not have the word 
belp in it (The Help system has three stacks all containing belp in their names; as you 
browse among the three Help stacks, you won't destroy the original exit destination 
stored in HelpExit.) 
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The three indented lines within the second handler, 


global HelpExit 
visual effect dissolve 
go to HelpExit 


are all simple command statements. The first, global HelpExit, is the same as in 
the first handler: it ensures that both handlers refer to the same global variable. The 
next command, visual effect dissolve, sets up the transition to the next card 
you go to, so that the image of the current card will fade into the image of the next. The 
go to HelpExit command takes you back to the card you were on before you 
entered the Help system. 


HyperCard External Commands 


The HyperCard interface allows you to build extensions to the HyperTalk language 
through external commands or functions. External commands, called “ex- 
commands,” and external functions, called “ex-functions,” are compiled Macintosh 
resources of type 'XCMD' and 'XFCN' respectively. ECMDs and XFCNs are 
written in other high level Macintosh programming languages, such as C or Pascal. 
One of the benefits of the external command feature is that you can concentrate all of 
your programming talent on providing added functionality to HyperCard, and leave 
the building of the user interface to artists and creative designers. You can build your 
function or procedure according to the rules described later in this chapter, and then 
call the XCMD from a HyperTalk script, which you assign to any of the HyperCard 
objects. 


How HyperCard uses XCMDs 


When HyperCard cannot locate a command called in a script, as is the case with an 
external command, HyperCard looks for a resource of type 'XCMD' with the same 
name as the unknown command. Likewise, when a function cannot be found, 
HyperCard looks for a resource of type 'XFCN'. Whenever a handler (for a 
command or function) is not found in a stack script, HyperCard immediately looks for 
an XCMD or XFCN in the currently open stack. The order of the search or inheritance 
order is: 


Button (or Field) 
Card 


home XCMD 
XCMD in HyperCard application file 
HyperCard command 


HyperCard External Commands 
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An XCMD or XFCN is a code resource with no header bytes Gust like a Macintosh desk 
accessory). You can move XCMDs and XFNTs from stack to stack with ResEdit or with 
any other resource moving tool. 


* Note: The procedure for moving compiled XCMDs and XFNTs is discussed in the 
HyperTalk Script Language Gutde. Additionally, a utility stack, called ResCopier 
copies XCMD and XFNT resources into HyperCard stacks. The ResCopier stack is 
available from HyperCard User groups. 


The only thing passed into an XCMD or XFCN is a pointer to a XCmdBlock. It looks 
like this: 

XCmdPtr = *XCmdBlock; 

XCmdBlock = 


RECORD 

paramCount: INTEGER; { the number of arguments) 

params: ARRAY[1..16] OF Handle; { the arguments} 

returnValue: Handle; ({ the result of this XCMD)} 

passFlag: BOOLEAN; ( pass the message on?)} 

entryPoint: ProcPtr; { call back to HyperCard)} 

request: INTEGER; { what you want to do} 

result: INTEGER; { the answer it gives) 

inArgs: ARRAY[(1..8] OF LongInt; { args XCMD sends HyperCard) 

outArgs: ARRAY[(1..4] OF LongInt; { answer HyperCard sends back} 
END; 


You read the arguments (they are handles to zero terminated strings), do whatever the 
purpose of this XCMD is, and optionally store a result into returnValue. All data values 
going to and from HyperTalk are zero-terminated ASCII strings 


Resources of type XCMD are commands, and resources of type XFCN are functions 
that return a value. If you store a result string into returnValue in a command, the user 
can get it by asking for "the result" (useful for explaining why there was an error). Ina 
function, you are expected to store the answer into retumValue. If you don't store 
anything, the result is the empty string. : 


If passF lag is false (the normal case), this XCMD or XFCN has handled the message 
and the script resumes execution. If passFlag is true, HyperCard searches the 
remaining inheritance chain for another handler or XCMD with the same name. This 
is just like the "pass" control structure in a script. 

The second part of the XCmdBlock record has to do with calling HyperCard back in 
the middle of your code to ask a question. If you wanted to manage the call to 
HyperCard yourself, you would fill inArgs with your arguments, put a request code in 
request, and JSR to the address in entryPoint. HyperCard returns the values you 
requested in outArgs and a result code in result. 
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Because the entire range of call back routines are packaged with HyperCard, you can 
simply call a Pascal or C procedure. The calls are documented in the HyperTalk Script 
Language Guide, available from the Apple Programmer's and Developer's 
Association CAPDA). 


Rules and limitations of building XCMDs 


Most macintosh programs are centred around an event loop. In most cases, the event 
loop is merely a large switch statement that calls the procedures that make up the body 
of your program (ie the user presses a button, pulls down a menu, etc). When the user 
takes an action, such as pressing a button, a procedure is called to handle it By using 
HyperCard's XCMDs, the buttons can be set up to call the routine directly, thus 
allowing HyperCard to handle the event looping. 


Many times it is useful to execute several commands in succession. Most users have a 
set of common procedures that they will execute in the same order again and again. 
That is why many programs have macro capability. By writing the procedures for your 
application as HyperCard XCMDs, end-users automatically have the ability to define 
macros with a user-friendly language. 


* Note: The discussion in this section applies primarily to the MPW C programming 
language. These limitations may not apply to other languages. 


Limitations of XCMDs 


Unfortunately, there is a price to be paid for all of the functionality that HyperCard 
brings. In this case, it is merely a few restrictions on programming. Because XCMDs 
are external to HyperCard, HyperCard cannot be aware of their individual data needs. 
To be more precise, XCMDs cannot use the AS register as a pointer to their global 
data, as HyperCard uses it for it's global data space. This means that your program 
(unless it uses a something other than AS for it's global data) cannot have any global 
variables, nor any static variables or initializer. This also true far strings. Fortunately, 
there are several possible workarounds for these problem areas. 


No Global Variables: As mentioned ealier, XCMDs cannot access HyperCard's 
global data space for private storage. This means that all variables for an XCMD must 
be passed either as parameters or declared within a C function. Unfortunately, it is 
sometimes necessary to share information between several XCMD's. There is a trivial 
workaround. 


Workarounds for global variables: HyperCard itself can access HyperCard's Global 
data space. By using Hypercard to keep track of the information that needs to be 
shared between XCMDs, this limitation can be easily by-passed. To do this, allocate 
some space (ie call NewPtr or NewHand1le) and store a pointer (Handle) to the 
space in a HyperTalk Global variable created for that purpose. 
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@ Note: HyperTalk globals are all stored as strings, so to store a pointer in a 
HyperTalk global, the address must be converted to a string first, and unconverted 
for later use. This also has the added advantage of allowing the you to know where 
that data is being stored in the event that you need to poke around with MacsBug or 
some other memory examining tool. 


No Statice Variables / Initializers: Static Variables or initializers also use the global 
data space, so they cannot be used either. If it is necessary to use static variables, it 
may be possible to achieve the same effect by storing the data with HyperCard. There 
is no way to implement static initializers. If it is possible to Dynamically initialize your 
data, the following sections may be of use. 


No Embedded Strings: This is probably the most annoying restriction of all. As 
embedded strings (such as "Hello’ in: strcepy(stri,"Hello"); ) are stored in 
the global data space they also cannot be used. There are at least three workarounds 
for this. CThis is not a problem with MPW Pascal, because Pascal can handle strings.) 


The recommended workaround for the lack of embedded strings is to utilize a resource 
of type 'STR '. When a string is needed, the appropriate resource can be retrieved 
with the GetResource toolbox call. This has the added benefit of simplifying 
international conversion of the XCMDs. 


Warning: 


If you change the current resource file, you must change If back when you are 
done with that XCMD, otherwise, Hypercard may get confused. There is a 
disadvantage to using ‘STR ' resources. When copying an XCMD from one 
stack to another, the 'STR ' resources must be copied also. Af present, 
there Is no standard for grouping resources together as ils done with Desk 
Accessories. 


Another method for loading strings into an XCMD is to utilize an assembly-language 


file. For Example: 


stringFoo PROC EXPORT 
DbC.B 'This is a string' 
ENDP ROC 
END 


If you are using MPW C, try this method of passing strings to an XCMD: 
extern char *stringFoo; 


® Note: The order of the link is important. The C file with the code MUST come 
before the asm file with the data. This has the advantage of keeping the data with 
the code (such as, when copying XCMD's), but it is not recommended. 


4-12 Chapter 4: HyperCard and CD-ROM (Alpha craft) 


The other method for including strings is to use assignment of integer constants. A 
longword can be loaded with a character constant of up to 4 characters. As the glue 
routines expect to be handed Pascal strings, this does require some extra work (ie 
loading the length of the string into byte 0). For Example: 


{ 
char mystring([20]; 
long *tmp; 


tmp = &(mystring[{1]); 
mystring({0] = (char)10; 


*tmp = ‘The '; 
*(tmpt+1l) = 'Stri'; 
*(tmpt2) = 'ng\0\0'; 
} 


This has the advantage of not requiring a separate resource, or the use of assembly to 
implement strings. It does tend to shorten the length of strings though. This also has a 
tendency to cause the MPW C compiler to generate code that will bomb on a MC68000 
based machine (such as the Mac+ and the Mac SE), and is also strongly not 
recommended. 


Building XCMDs 


The following section will take you through the development of an XCMD step by step, 
from the initial coding to the installation and debugging. The source of two sample 
XCMDs are included, along with some observations and hints along the way. 


Development Environment 


The selection of the proper development environment is very important. Currently, 
MPW is the only version of C that both has Glue and has been tested. Lightspeed C 
does have some Glue, but there appears to be some problem with the code 

generation. No matter which development system is being used, some way of moving 
resources is necessary. Resedit is a popular Macintosh resource moving utility, 
however, there are several HyperCard stacks that contain resource moving XCMDs. 
The APDA XCMD developer's kit Cor an equivalent for the development environment 
that you are using) is also required, as it contains the Glue routines that are essential for 
talking to HyperCard. 
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XCMD Code 


XCMDs are pure code resources that are executing under HyperCard. HyperCard call 
the XCMD much as it would call any other subroutine. Because an XCMD is not a 
stand alone program, it must not initialize the managers, as this might cause trouble 
for HyperCard. 


Now that youhave all of the background, it is time to begin the actual coding. To make 
the following example XCMDs work, resources of type 'STR ' must be in the Stack. 


'STR ' Resources: The following 'STR ' resources must be in the HyperCard 
Stack with the example XCMDs (you can use ResEdit to create them): 


#1 £#=“pBIO" 
#2 “retv" 


#33 "incr 


Sample XCMDs 


This first is the most simple: it merely gets the HyperTalk global variable "INCR", 
converts it to an integer, adds one to it, and puts it back into HyperCard. The second 
is an XFCN. It works the same, except it is passed a parameter, which it converts to an 
integer, increments, converts it back to a string, and places it into retumValue. The 
third executes a driver call (Ki111I0). This will not work unless you first write an XCMD 
to open a driver, and place a pointer to the PBIO (parameter block I/O) struct into 
the global "PBIO". 


The first. XCMD example, XPLUS1, is presented below: 


#include <types.h> 
#include <memory.h> 
#include <resources.h> 
#include "HyperxCmd.h" 


pascal void XPLUS1(p) 


/* 
this procedure gets a global variable “INCR" from 
Hypercard,increments it, and passes it back to Hypercard. 
=) 
XCmdBlockPtr p; /* parameter passed by HyperCard */ 
{ 
unsigned longl; /* the data from HyperCard */ 
Handle 8, NewHandle(); /* The Handle to the data from/for 
HyperCard */ 
Handle $1; /* Handle for the variable name */ 
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Sl = GetResource('STR ',33); 


H = GetGlobal(p,*S1l); 


1 = atoi(*#); 
strings 


DisposHandle(8) ; 
we 


de- 


KR = NewHandle (30); 
stcu_dli(*H,1,30); 


SetGlobal(p,*S1,8); 
DisposHandle(H); 
ReleaseResource (S11); 


return; 
) 


#include <XCmdGlue.inc.ec> 


/* 


/* 


get the variable name from rsrce 
file */ 


asking HyperCard for the value in 


the variable "INCR" */ 


/* 


/* 


/*® 


/* 


/*® 
/* 
/* 


/* 


/* 


ALL HyperCard variables are 


converting it to a longword */ 


HyperCard creates a Handle when 
ask for a giobal, so we need to 


allocate it. */ 


here we act on the variable given 
in this case, we increment it. */ 


Create a new handle to pass the 
modified data back to HyperCard */ 


convert it from a long word to 
a string */ 


pass the value to HyperCard */ 
deallocate the Handle */ 
release the resource */ 


return to HyperCard */ 


Glue! */ 


The second XCMDs example, XPLUS1P is presented next. 


#include <types.h> 
#include <memory.h> 
#include “HyperXCmd.h" 
pascal void XPLUS1P(p) 


/* 


this procedure is passed a parameter by HyperCard, increments it, 


and 


places the resulting number into 


*"returnValue". 
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*/ 

XCmdBlockPtr p; i 
{ 

unsigned longl; [* 
Handle H, NewHandle(); /* 
H = p->params(0]; /* 
1 = atoi(*#H); /* 
strings 

l++; j* 
increment 

KH = NewHandle(30); /* 
stcu_d1l(*H,1,30); {* 
p->returnValue = &; 7% 
return; /* 
} 

#include <XCmdGlue.inc.c> /* 


parameter passed by HyperCard */ 


the data from HyperCard */ 
The Handle to the data from/for 
HyperCard */ 


get the value passed as a 
parameter to the XCMD/XFCN */ 


ALL HyperCard variables are 


converting it to a longword */ 
here we act on the variable 
given... in this case, we 

164 Sy 


Create a new handle to pass the 
modified data back to HyperCard */ 


convert it from a long word to 
a string */ 


pass the value to HYPERCARD */ ee 


/* note the Handle is NOT ( 
deallocated! */ 


return to HyperCard */ 


Glue */ 


The third XCMD example, KILLIO, is presented next. 


® Note: This XCMD will only work if you write an XCMD to open a driver, and place 
a pointer to it's PBIO struct in the HyperCard global "PBIO”. 


#include <Devices.h> 
#include <Memory.h> 
#include <resources.h> 


#include 


long 
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"HyperXCmd.h" 


atoi(); 


Chopter 4: HyperCard and CD-ROM (Alpha araft) 


pascal void KillIO(paramPtr) 


XCmdBlockPtr paramPtr; 
{ 
Handle H; /* Handle for passing values to and 
from HyperCard */ 
CntrlParam *PBCntrl; /* Control Parametre Block Ptr */ 
OSErr Error? /* Possible Error Value (Gasp!) */ 
unsigned long tmp; /* temporary variable for conversion 
of 
ptr to the I0Param Block */ 
Handle S14:523 /* Handles to hold string resources 
aie § 


Sl = GetResource('STR ',1); /* Get the string "PBIO" */ 
S2 = GetResource('STR ',2); /* Get the string "“retv"™ */ 


H = GetGlobal(paramPtr,*Sl); /* Get the HyperCard Global var who's 


name is contained in ‘STR ' rsre 
#1 
=/ 
tmp = atoi(*H); /* these block coerces a */ 
PBCntrl = (CntrlParam *)tmp; /* string into a pointer to */ 
DisposHandle(H); /* the ControlParam Block */ 
PBCntrl->ioCompletion = OL; /* we don't need anything executed 
on 
exit */ 


Error = PBKillIO(PBCntrl, false); /* the Control Call */ 


/* return error */ 


H = NewHandle(20); /* Allocate a Handle for the 
data */ 

Stel d(* hi, crror,.20)y /* Convert it to a string */ 

SetGlobal(paramPtr,*S2,H); /* set the HyperCard Global */ 

DisposHandle(H); /* dispose of the handle */ 

ReleaseResource(S1l); /* release our resources */ 


ReleaseResource(S2); 

return; | /* return */ 
} 
#include "XCmdGlue.inc.c"” 
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Compiling/Linking 


Once the program is written, it must be compiled and linked into a code resource. The 
easiest way to do this for a large number of XCMDs (or XCMDs using several 'c' files) is 
with a Makefile. There are 4 makefiles included here, one for each of the sample 
XCMDs, and one more for XPLUS1P as an XFCN. 


In all of the Makefiles, there is a "-m" option, followed by a string. This is the name of 
the main routine. Because we have declared the XCMD to conform to the Pascal 
calling conventions, the name of the main procedure must be capitalized, as Pascal 
converts everything to uppercase. 


XPLUS1 Makefile 


# File: XPlusl.make 

# Target: XPlusl 

# Sources:. XPlusl.c XCmdGlue.inc.c 

# Created: Tuesday, December 22, 1987 11:42:57 


XPlusl.c.o f XPlusl.make XPlusl.c XCmdGlue.inc.c 
C -g XPilusil.c 

unixst2d.c.o f XPlusl.make unixst2d.c 
C -g unixst2d.c 

XPlusl ff XPlusl.make XPlusl.c.o unixst2d.c.o 
Link -sg XPlusl -m XPLUS1 @ 
-rt XCMD=3 @ 
XPlusl.c.o @ 
unixst2d.c.o @ 
"(CLibraries}"CInterface.o @ 
"(CLibraries}"StdCLib.o @ 
"(CLibraries)"CRuntime.o a 
-o XPlusi.XCMD 


XPLUS1P XCMD Makefile 


$ File: XPluslP.make 

# Target: XPluslP | 

$ Sources: XPluslP.c XCmdGlue.inec.ec 
# 


Created; Tuesday, December 22, 1987 11:42:57 
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XPluslP.c.o f XPluslP.make XPluslP.c XCmdGlue.inc.c 
C -g XPluslP.c 
unixst2d.c.o f KXPluslP.make unixst2d.c 
C -g unixst2d.c 
XPluslP ff XPluslP.make XPluslP.c.o unixst2d.c.o 
Link -sg XPluslP -m XPLUS1P @ 
-rt XCMD=3 @ 
XPluslP.c.o a 
unixst2d.c.o @ 
"(CLibraries})"CInterface.o d 
"(CLibraries}"StdCLib.o @ 
"(CLibraries}"CRuntime.o a 
-o XPluslP.xCMD 


XPLUS1P XFCN Makefile 

$ File: XPluslP.make 

# Target: XPluslP 

$ Sources: XPluslP.c XCmdGlue.inc.c 

$ Created: Tuesday, December 22, 1987 11:42:57 


XPluslP.c.o f XPluslP.make XPluslP.c XCmdGlue.inc.c 
C -g XPluslP.c 
unixst2d.c.o f XPluslP.make unixst2d.c 
C -g unixst2d.c 
XPluslP ff XPluslP.make XPlus1lP.c.o unixst2d.c.o 
Link -sg XPluslPF -m XPLUSI1P @ 
-rt XFCN=3 d 
XPluslP.c.o a 
unixst2d.c.o @ 
"(CLibraries)"CInterface.o a 
"(CLibraries}"StdCLib.o @ 
"(CLibraries}"CRuntime.o a 
-o XPlusiP.XFCN 


KILLIO Makefile 

# File: KillIO.make 

# Target: KillIoO 

# Sources: . KillIo.ec 

$ Created: Tuesday, December 22, 1987 15:18:28 
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KillIO.c.o £ KillIO.make KillIO.c 
C -g KillIO.c 

BCD.c¢.0 Ff ‘BCOwe 
Cc #«g BCD.c 

unixst2d.c.o f unixst2d.c 
C -g unixst2d.c 

Kil1IO ff KillIO.make @ 
BCD.c.o a 
unixst2d.c.o @ 
Ki 1116.60 

Link -rt XCMD=99 -m KILLIO @ 

-sg KillIO ad 
KillIO.c.o @ 
BCD.c.o @ 
unixst2d.c.o @ 
"(CLibraries}"CInterface.o @ 
"(CLibraries})"CRuntime.o @ 
"(CLibraries)"StdCLib.o da 
-o KillIO.XCMD 


installing 


To Install an XCMD/XFCN into Hypercard, ResEdit or something of a similar ilk is 
required. After the XCMD/XFCN has been successfully compiled and linked, a file of 
type 'APPL' is created. This contains the XCMD/XFCN code resource. With this file, 
do the following: 


1. Open the application file with ResEdit 


2. Open the XCMD (or XFCN) resource. If you are using the examples supplied with 
this document, there should be only one resource listed there: #3 (or number #99 for 
the KillIO XCMD). 


3. Select that resource. 


4. Copy it (use either the menu or -C) 


5. Open A HyperCard Stack 
6. Paste. (again, use either the menu or -V) 


7. Quit. 
The XCMD/XFCN should now be installed into that HyperCard Stack. 
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Debugging 


An XCMD can be debugged much as you would any other procedure. For example, 
compile with the '-g' option to generate symbols for Macsbug. Debugger calls can 
be made, although DebugStr() will not work with a literal string. Under MPW C, 
DebugStr() assumes that it is being passed a Null-Terminated string, and converts 
the string to Pascal format. It doesn't convert it back. If you call cDebugStr (), this 
conversion does not take place. 


Usually it is a good idea to insert Hypertalk's "the Heapspace" calls in between XCMDs 
to insure that all handles are being de-allocated properly. If there is a rapidly 
diminishing heapspace, it may be a sign that a handle is not being disposed of 
properly. 

Another possible area for bugs to occur is with strings Hypercard treats ALL variables 
as strings, sO anything that Hypercard is storing must be a null-terminated string, 
however, the glue routines all use Pascal Strings. (Be careful in string conversions!) 


Calling an XCMD From HyperCard 


There is very little that is special about calling XCMDs from Hypercard... Just call it by 
name. Parameters follow. With XFCNs, the parameter list must be enclosed in 
parenthesis. I found it best to have a handler for each XCMD, located in the stack 
script. This allowed me to ensure that the appropriate global variables were allocated 
prior to the call being made. The following examples should illustrate: 
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on doXPlusl 
global incr,retv -- declare the global variables 
XPlusl -- call the actual function 
put the HeapSpace into card field "“HeapSpace" 
-- check to see if we are deallocating 
-- everything that is allocated. 


end doxPlusi 


on doxXPlusilP ~- as an XCMD 
global incr,retv -- declare globals 
put returnValue of XPluslP incr into incr -~ do the command 
-- and save the results 
put the HeapSpace into card field "“HeapSpace” -- check to see if 
-- we are deallocating everything that is 
-- allocated. 


end doxPluslP 


on doxXPlusiP “-- as an XFCN 
global incr,retv -- globals 
put returnValue of XPluslp(incr) into iner -- do the command 
-- and save the results 
put the HeapSpace into card field “HeapSpace” ~- check to see if 


-- we are deallocating everything 
-- that is allocated. 
end doxXPlusl 


Calling the XCMD interactively 
To call an XCMD interactively, just call its handler from a button: 


on mouseUp 

global incr 

doxPlusl 

put incr into card field "foo" 
end mouseUp 


Or the call the XCMD from the HyperCard Message Box: 


doXPlusl 
put incr into card field “foo” 


The line “put iner in card field "foo" ” allows changes to the variable to be 
seen after execution. 
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Calling the XCMD with Macros 


As an XCMD is just an extension to the HyperTalk language, they can be used just like 
any other feature of HyperTalk. This means that several XCMD calls can be made 
from within the same button handler. Thus are macros added to the features of a 
HyperCard application/stack. Additionally, all af the Hypertalk control structures 
(such as repeat and if) can be used for flow control within the macro. As this is all 
done at the Hypertalk level, the C Cor whatever language that is in use) code does not 
need to be modified or recompiled. Thus an end-user who is not experienced in 
programming can create macros. One small example of the utility granted by this is 
that a macro can be written for any common task, and then can be executed with the 
touch of a single button 
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HyperCard as a data retrieval engine 


In this section we will provide an overview of two HyperCard search engine scenarios 
for CD-ROM information access. The first scenario covers designing a CD-ROM 
entirely with HyperCard and the second scenario describes working with an existing 
CD-ROM designed initially for the non-Macintosh environment. 


Designing a CD-ROM search engine with HyperCard 


Two important pieces of code need to be written for a search engine that uses 
HyperCard stacks (referred to as stackware). The first piece of code is the inversion (or 
data analysis) engine, which you will use to build an index of your stack in an auxiliary 
table. The inversion engine is run after you have built your stack and are ready to freeze 
it, and put it on CD-ROM. To use the inversion engine you must first write a 
HyperCard script, using HyperTalk, that effectively goes through the entire stack; 
every card, every field, every word, and calls the inversion engine, which records 
every word in a the stack and where it occurs in the auxiliary table. For example, if the 
inversion engine was recording the word Apple, and found two hundred occurrences 
in the stack, it would build an auxiliary table containing word descriptor information 
like the first occurrence of Apple was on card number 2, background field 3, word 
offset 100, and so on. The data structure for the word descriptor is as follows: 


Card ID number (32 bits) 
Background ID number (32 bits) 


Background /Card field flag a bit) 


Field ID number (7 bits) 


Word offset in field (<16 bits) 


When the inversion process is done, and the auxiliary table is built, it is stored along 
with the stack to be placed on the CD-ROM. Because the read-only text on the CD 
cannot be changed, the table is a static data structure. An example HyperCard script 
for building an auxiliary table from a HyperCard stack is presented below. 


function cleanName thisName 
-~strip quotes from field or bkgrnd name 
delete first char of thisName 


delete last char of thisName 
return thisName 
end cleanName 


on emit entity, cardNum, bkgndID, cardID, bkCd, fieldID, wdOffset 
--write one word & descriptor vector to the output file 
global outFile 
put cardNum & tab & bkgndID & tab & cardID & tab & bkCd & tab é- 
fieldID & tab & wdOffset & tab & entity into outString 
--log to the message box for progress indicator 
put outString 
~-replace linefeed with return for non-unix usage 
put linefeed after outString 
write outString to file outFile 
end emit 


function okChar theChar 

~~check to see if char type is alphanumeric 
if theChar is empty then return true 
if theChar > "/" and theChar < ":" then return true 
if theChar > "@" and theChar < "(" then return true 
if theChar > "_" and theChar < "{" then return true 
return false 

end okChar 


function stripWord theWord 
--remove non~alphnumerics from the ends of word 
repeat while not okChar(first char of theWord) 
delete first char of theWord 
end repeat 
repeat while not okChar(last char of theWord) 
delete last char of theWord 
end repeat 
return theWord 
end stripWord 


on invert 
global outFile 
ask "Output file?" 
if it is empty then exit invert 
put it into outFile 
open file outFile 
put number of last bkgnd into lastBkgnd 
--loop over all bkgnd types 
repeat with thisBkgnd = 1 to lastBkgnd 
go to next card of bkgnd thisBkgnd 
put the id of this bkgnd into thisIdent 
put the name of this bkgnd into thisName 
-~ record bkgnd name 
if word 3 of thisName is empty then 
emit "&”" & cleanName(word 2 of thisName) ,0,thisIdent,0,0,0,0 
end if 
put number of bkgnd fields into endField 
-- record bkgnd field names 
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repeat with thisField = 1 to endField 
put the id of bkgnd field thisFlield into fieldIdent 
put the name of bkgnd field thisField into fieldName 
if word 4 of fieldName is empty then 
emit "™*" @€ cleanName(word 3 of fieldName) ,O,thisIdent,0,0,=— 
fieldIdent, 0 
end if 
-- end field repeat 
end repeat 
put the id of this card into cardIident 
put cardIdent into endIident 
-- loop over all cards in bBkgnd 
repeat 
put number of this card into thisNum 
-- loop over bkgnd fields in card 
repeat with thisField = 1 to endField 
put the id of bkgnd field thisField into fieldIdent 
put number of words in bkgnd field thisField into endWord 
-- loop over words in field 
repeat with thisWord = 1 to endWord 
put stripWord(word thisWord of bkgnd field thisField) into theWord 
if theWord is empty then next repeat 
emit theWord,thisNum,thisIdent,word 3 of cardident,0,— 
fieldIdent,thisWord 
end repeat 
end repeat 
-- loop over card fields, if any 
put number of card fields into endCField 
repeat with thisField = 1 to endCField 
put the id of card field thisFileld into fieldIdent 
put the name of card field thisField into fieldName 
“~~ check if named 
if word 4 of fieldName is empty then 
emit "™*" & cleanName(word 3 of fieldName) ,thisNum,- 
thisIdent,word 3 of cardIdent,1, fieldident,0 
end if 
-- loop over card field words 
put number of words in card field thisField into endWord 
repeat with thisWord = 1 to endWord 
put stripWord(word thisWord of card field thisField) into theWord 
if theWord is empty then next repeat 
emit theWord,thisNum,thisIdent,thisNum,1, fieldIdent,thiswWord 
end repeat 
-- end card field repeat 
end repeat 
-- end card repeat 
go to next card of bkgnd thisBkgnd 
put the id of this card into cardIdent 
if cardIdent is endIdent then exit repeat 
end repeat 
-- end background repeat 
end repeat 
end invert 
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The second piece of code that must be written is the runtime search function. The 
search function interrogates the auxiliary tables, based on the particular set of words, 
and retrieves the desired information. This is a boolean retrieval model, which 
essentially bypasses the find mechanism of HyperCard and hands back a list of 
cards by ID which contain the words that match the search criteria. The pieces that 
make up the HyperCard CD-ROM and their interaction is shown in Figure 4-3. 


Data preparation 
rae Vn panel 
S 
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Interface —-, ae |Z 
3 > Ea 


HyperCard 


Figure 4.3 
Pieces of a HyperCard based CD-ROM 


A friendly interface 


The type of ASCII search interface described above, would be far too crude to present 
to the user. However, HyperCard can be used to create a graphical interface which 
provides the user with fields and buttons that access the underlying search commands. 
For example, to present a templated search, you might build a card with an array of 
buttons and fields like those shown in Figure 4-4. 
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Figure 4-4 
Example HyperCard interface 


Working with an existing CD-ROM 


In this scenario, a library of information already exists on a CD-ROM. This CD-ROM 
has been prepared on a mainframe for use on a PC. The CD-ROM uses a PC retrieval 
engine and interface, which may include the use of familiar PC user function keys, 
mice, and windows. 


Most CD-ROM developers and information providers need to leverage the software 
investment, and write the retrieval engine in a portable language, such as; C or Pascal, 
so that it can be moved onto other operating environments. This may or may not be 
the case with the user interface portion of the code for the CD. Therefore, one of the 
big problems in the past that kept information providers from developing a Macintosh 
interface/application has been the great expense of porting the PC interface to the 
Macintosh. 
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Because the PC interface is not very portable (command lines and function keys aren’t 
standard on the Macintosh), and most PC programmers are not familiar with the 
Macintosh programming environment, it may take three months or more just to 
understand how to implement the interface. This is where the HyperCard scenario, 
described below, can save you both time and money. 


“HyperCard provides a complete set of tools to compose the human interface and 
customize the retrieval model to fit the needs of your application. Engineering 
development time can be cut a cea in half by using HyperCard as a user 
interface construction kit. 


First, take the existing CD-ROM and retrieval engine and port it to the Macintosh | 
operating environment. If the job is done right, there should be a clean interface 

layer consisting of function calls to the retrieval engine. After building the clean 
interface layer, you recode the function calls to have a shell around them, so that they 
look like HyperCard External Commands (XCMDs). Then you use HyperCard to build 
the graphic Macintosh interface with the proper hooks for the XCMDs. The block 
diagram in Figure 4-5, shows the steps described for this HyperCard scenario. 


Funetion calls 


Port ry engine 


Fctrieval  runction calls eB 
@ . jeva 
> |< 


erCard 
XCMDs Sa 
Figure 4-5 


interface 
Preparing an existing non-Macintosh CD-ROM for the Macintosh environment 
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ria, 


If you want to work with an existing text-based CD-ROM that contains a card catalog for 
a ceed h you might'use a HyperCard interface that includes buttons and fields like 
those show in Figure 4-6. 
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Figure 4-6 
Sampie card for text search 


These buttons and fields provide the user with an intuitive way to supply the search 
criteria. Instead of typing in some arcane string of commands, the user would click on 
the Author, Title, or Subject field, and start to type. When the user starts typing in the 
Author field, a list of available authors would appear. The user could then select the 
author he or she wants from the list, which would then bring up a list of corresponding 
tides, as shown on Figure 4-7. 
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Figure 4-7 
Book titles corresponding to author's name 
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If the user desired more information about one of the titles, he/she should simply click 
on the corresponding name. The user would then be presented with more detailed 
information, as shown in Figure 4-8. 


Author: Ken Salaiz 
Title. A Visitor's Guide to France 


Published: John Wiley & Sons; New York, NY: 1983 


Topics: travel 


foreign countries 


Catalog Number: |877.49 )453n 


@ Let | oo 


Figure 4-8 

Detailed information in catalog card 

Once you've ported the retrieval engine and corresponding XCMD interface to the 
retrieval engine, the interface shown above is relatively easy to build with HyperCard. 
The information requested by the user is simply returned to HyperCard fields that 
correspond to the information being requested. Each field can have a unique look 
according to its properties. Fields can be shadowed, scrollable, plain rectangles, 
transparent, and opaque. Fields can contain any font that is available in the user's 
System file. 


® Note: If you plan to use fonts that are not in the standard release of the Apple 
Macintosh System file, you will have to license and supply the unique fonts with 
your product. 


HyperCard as a data retrieval engine 4-31 


More information about fields is available in the HyperCard Script Language Guide 
and the HyperCard Owner's Guide.One of the best way to learn about the possible uses 
for HyperCard, and how it will enhance your CD-ROM product on the Macintosh, is 
hands-on experimentation. 
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Chapter 5 


Networks and 
AppleCD SC 


This chapter includes a brief overview of how to get the AppleCD SC ready for sharing 
information, and making it available to Macintosh, Apple II, and PC users on the 
network who have AppleShare workstation software. Installation and genera! 
AppleShare administrator’s tasks are covered in the AppleShare Administrator's 
Guide. 


AppleCbD SC on the AppleTalk network system 


You can attach one or more AppleCD SC drives to a Macintosh working as an 
AppleShare file server on the AppleTalk network system. All Macintosh HFS, Apple I 
ProDOsS, and High Sierra formatted CD-ROMs will work on the AppleTalk network as 
an AppleShare server volume. 


Naming the CD-ROM server volume 


It’s a good idea to give a CD-ROM server volume a name that indicates its contents. 
For example, you may want the information for different work groups to be on separate 
volumes. You could name each volume after one of the work groups. 


Whatever name you choose, be sure that each volume name is unique. Do not use the 
same name for more than one volume. 


If only Macintosh and PC users will be accessing the CD-ROM volume, use a name up 
to 27 characters long. Do not use a colon (:) or begin with a period (.). 


If Apple II users will be accessing the CD-ROM volume, you must use a valid ProDOS 
name—up to 15 characters, including letters, numbers, and periods. You must begin 
with a letter. Do not use spaces. 


Important 


You cannot rename CD-ROMs or other locked disks. If qa CD-ROM doesn't hove 
G valid ProbDOS name. Appie ll users cannot access it on the network. In 
addition, Appie Il users can open only those folders and files with valid ProDOs 
names. 


When using CD-ROM as a server volume, you must install AppleCD SC device driver 
on the server startup volume and on the Server Administration disk. CYou also need 
the device driver on the Server Administration disk so you can access the CD-ROM 
while preparing server volumes. A CD-ROM cannot be used as a startup volume 
because you cannot change its contents.) 


The AppleShare server administrator can change the See Folders and See Files 
privileges for CD-ROMs (and other locked volumes) but, only for the volume, not for 
the folders on the volume. 
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Chapter 6 


AppleCD SC Functional 
Overview 
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CD-ROM technology—at a glance 


To understand how the AppleCD SC works, you should first understand how the CD- 
ROM media is constructed and how the data is stored on and read back from the CD- 
ROM. 


How CD-ROMs are made 


The CD-ROM is a thin plastic disc 12 cm. in diameter. Information is stored in a 
plastic-encased spiral track on one side of the disc. The spiral track consists of shallow 
depressions (pits) in a reflective layer. During the CD-ROM manufacturing process 
the binary information is encoded as pits molded into the disc, and then a reflective 
aluminum layer is applied to the embossed surface. This aluminum layer is then 
covered with a protective plastic film. The information is stored in the length of the 
pits and the distance berween them (known as land). The CD-ROM encoding scheme 
encodes binary “1” bits as the transition from pit to land or land to pit and “0” bits as 
constant pit or constant land. A cross section of the CD-ROM is shown in Figure 6-1. 
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Figure 6-] 
A cross-section of the CD Information surface 
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How AppleCD SC reads the CD-ROM 


The spiral track on the CD-ROM is read by a noncontact optical head, which scans the 
disc radially as the disc spins above it To retrieve the data from the CD-ROM, a low- 
power beam, from a gallium arsenide laser in the optical head, is focused through the 
transparent layer of the disc onto the spiral track and reflected back into the optical 
head. The reflected light varies depending on whether the beam is focused on land or 
on a pit. Land fully reflects light, whereas interference effects occur when the laser 
beam overlaps a pit. The photoelctronics in the optical head measure the differences 
in the reflected light intensity. The modulated-reflected light is converted to a radio- 
frequency signal by the photodetector in the optical head. The signal is sent over the 
SCSI bus to the computer and translated back into text, graphics, or sound for use in 
applications. 


About the AppleCD SC CD-ROM drive 


The AppleCD SC is a lightweight, self-contained unit that uses laser light to read digital 
and analog information recorded on the reflective surface of a CD-ROM or audio 
disc. 

The main components of the AppleCD SC include: 


© a disc drive mechanism comprising an optical pickup head, spindle motor, and 
caddy handling mechanism 


analog and digital servo electronics to maintain correct focus, tracking, and 
spindle motor speed 


digital electronics to read the recorded data and provide error correction 
a system controller 

a SCSI controller to communicate with the host computer 

analog electronics to output conventional CD-Audio stereo sound 

© the power supply assembly 


0 


ooaa oOo 


How these components interact is shown in the functional block diagram, Figure 6-2. 
The modules (excluding the power supply) are described following the block diagram. 
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A bleck diagram of the AppleCD SC functional modules 


The disc drive mechanism consists of a spindle servo motor, an optical pickup, and a 
cartridge handling mechanism. The servo motor rotates the CD-ROM at a variable 
speed, so that the linear speed of the focussed laser spot on the disc surface remains 
constant: the farther the track is from the center, the slower the servo speed. The 
optical pickup is a noncontact pickup that reads the disc by monitoring the focused 
laser spot reflected from the surface of the CD-ROM. 


Both the spindle and optical pickup mechanisms are controlled by the mechanism 
controller microprocessor and analog servo electronics. The radio frequency signal 
is digitized and passed to the demodulator and Cross Interleave Reed-Solomon 
Coding (CIRC) error correction electronics. The CIRC corrects most CD-ROM data 
errors in real time. The Mechanism Controller controls the mechanical assemblies: 
the focus of the laser light source, the tracking for the optical pickup, and the spindle 
motor speed. 
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The analog electronics for audio output make it possible for you to listen to CD stereo 
recordings. The analog electronics includes a digital-to-analog converter and a 
stereo audio amplifier stage to drive headphones. The analog electronics convert the 
digitally recorded audio information on the audio CD into an analog signal that is 
amplified and sent through the stereo headphone jack and the stereo jacks on the back 
of the AppleCD SC. The audio signal sent to the stereo jacks must be output through 
amplified speakers or input into an amplifier which in turn drives a separate set of 


speakers. 


The digital electronics for CD-ROM make it possible for you to retrieve data stored on 
CD-ROMs. The digital electronics processes the digital information stored on the 
CD-ROM so that your computer can read and process it. Included in the digital 
electronics is the CD-ROM layered error correction circuitry, which provides a bit 
error rate of less than 1 in 10!* bits. This powerful error correction circuitry corrects 
any errors remaining after the CIRC stages. CD-ROM layered error correction is one 
of the key differences that separates the CD-audio players from CD-ROM drives. The 
error rates on typical CD-audio units are much higher than that of CD-ROM drives, 
because the human ear doesn’t hear minor flaws in the music. CD-ROM, on the 
otherhand, can’t have the rates of errors seen on CD-audio players passing through to 
the computer. 


The system controller processes control information received by the SCSI controller 
from the computer and routes control instructions to the various electromechanical 
modules in AppleCD SC. 


The SCSI controller provides the communication link between the AppleCD SC and 
host computer. The SCSI controller receives commands from the host and transfers 
them to the system controller. It also returns status information and data to the host 

computer from AppleCD SC. The SCSI controller has a 64K data buffer that ensures 

data throughput to the host computer is maximized. 
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Chapter 7 


AppleCD SC CD-Audio 
and Sound Production 


This chapter examines the differences between stereo CD-Audio Red Book and 
digitized sound for CD-ROM Yellow Book, and describes how to integrate sound into 
applications to enhance other CD-ROM data. It also discusses the control protocol 
that is used in the Apple He CD Remote to access the AppleCD SC CD-Audio features. 


CD-Audio and digitized sound for CD-ROM 


There are several differences between CD-Audio and CD-ROM sound. CD-Audio is 
the standard used to create the stereo CDs you play on CD players. CD-Audio is said 
to produce the best sound quality of any recording medium. Using stereo sound 
interleaved with graphics and text data would be great However, there is a serious 
drawback involved in trying to mix CD-ROM and CD-Audio tracks on the same CD- 
ROM. You can experience a loss of performance in your application. The CD-ROM 
drive not only has to seek to a different area on the disc, but also has to switch between 
CD-ROM and CD-Audio modes of operation. Switching modes can take up to one 
second, and a long seek from CD-ROM data to the requested CD-Audio track could 
take another half second. The user would hear and possibly see the change in 
application performance. 


In contrast, using sound digitized for CD-ROM could be accessed much faster, 
because the drive doesn’t have to make a mode change and the sound is stored as 
another file in the CD-ROM format. Additionally, if the sound was digitized at 
sampling rates comparable to CD-Audio sampling rates, the actual difference in the 
quality of the sound would be almost unnoticeable. (Sound sampling is described later 
in this chapter). This is not to say that CD-Audio doesn’t have uses on CD-ROM. As a 
simple example, your application could be an instructional piece on the sounds of 
musical instruments. The user could select a period in the history of music, and 
choose from a group of instruments for that period. Once the instrument was selected, 
the user might be presented a picture with some descriptive text about the selected 
instrument and hear the sound of the instrument played in true stereo CD-Audio. The 
sound would be played after the graphics and text is displayed on screen, making the 
user feel it is more of a natural transition in the program. 
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Using sound in applications 


Sound is an important piece of any multi-media application designed to work with the 
AppleCD SC. The combination of Macintosh and HyperCard provide an inexpensive 
hardware and software development environment for multi-media CD-ROM projects. 
The mixture of sound, graphics and text will certainly be the ideal way for many of the 
future training and educational CD-ROM applications to present instructional ideas 
and information. Industrial training applications might use HyperCard and sound to 
add life to training diagrams, textual instructions, and parts lists. Educational 
“HyperCard films” can be threaded through reference material, using the attractive 
power of animation and music to draw students’ attention to graphic and textual 
content, which illustrate the class curriculum. 


The following section describes methods for getting sound into the Macintosh for use 
with HyperCard multi-media applications. 


* Note: To make understanding the following sections easier, you should have a 
good working knowledge of HyperCard and the HyperTalk programming 
language. 


HyperCard and sound 


HyperCard’s HyperTalk language allows you to build tools for the integration of sound 
into Macintosh HyperCard applications. Simple HyperTalk scripting can extend 
sound clips into full length synchronized sound and graphics films. HyperCard films 
achieve a feel similar to video production, and can be played straight through or 
interactively controlled by the user. You can use HyperCard scripts to build 
presentations and training materials, create narrated tours of HyperCard databases on 
CD-ROM, or do something as creative as design talking yellow pages for a telephone 
book. More information about HyperCard and sound will be included in a future 
release of this manual. 


Accessing the AppleCD SC CD-Audio features 


One of the features of the AppleCD SC is the capability to operate in the CD-Audio 
mode (the Phillips/Sony Red Book specification). As described earlier, the CD-Audio 
mode allows you to play audio CDs on the AppleCD SC, like you would on a stereo CD 
player. However, unlike the stereo CD player, the AppleCD SC CD-Audio mode is 
only accessible through software control. initiated from a host computer This chapter 
discusses the command protocol for accessing the CD-Audio feature of the AppieCD 
SC. 
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Software written to use the AppleCD SC CD-Audio control and status calls accesses the 
AppleCD SC through the SCSI Manager and AppleCD SC device driver on the 
Macintosh and through the SCSI SmartPort interface on the Apple Ile and Apple IIGS. 


@ Note: To ensure AppleCD SC application compatibility in the future, always make 
the SCSI control and status calls through the Macintosh AppleCD SC device driver 
or Apple II SmartPort, rather than going directly to the device. 


The AppleCD SC audio control and status calls are listed separately in Chapter 6, 
“AppleCD SC Software.” 


In this chapter we will use the Apple Ile CD Remote program as an example of how to 

implement CD-Audio control of the AppleCD SC. In the example only the protocol of 

the modules that actually perform the main body of the program are described. The 

bitmaps that graphically represent the remote control unit on the screen are not 

discussed. 

* Note: You can also access the CD-Audio capability of the AppleCD SC by using 
HyperCard XCMDs to make audio calls directly through the AppleCD SC device 
driver. 


More information about the command protocol for accessing the CD-Audio feature of 
the AppleCD SC will be included in a future release of this document. 
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Chapter 8 


AppleCD SC SCSI Commands 
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AppleCbD SC device specific SCSI commands 


This chapter describes the AppleCD SC device specific SCSI commands. The 
command descriptions are provided to help software developers program AppleCD 
SC device drivers for Apple and non-Apple computers. 


The Macintosh and Apple IT AppleCD SC device resource software provides all of the 
functionality most applications require, and we strongly recommend using the Apple 
device resources when working with Apple computers. 


Important 


If you attempt to create your own Macintosh or Apple || AppleCD SC device 
resources, those resources may become Incompatible with future releases of 
the Macintosh and Appie |i Systern software. 


The Macintosh AppleCD SC device resource command and status calls and Apple I 
AppleCD SC SmartPort calls are described in Chapter 2, “AppleCD SC Software.” The 
Group 0, Group 1, and Group 6 AppleCD SC specific SCSI device commands are 
described below. The AppleCD SC SCSI commands are provided in an attached 
document enuded, “Apple CD-ROM SCSI Command Set,” which will be incorporated 
into this document in a future release. 
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PPLE CD ROM _COMMAND SET 
(Revision 1.4, February 15, 1988.) 


gr 


The attached document is a fourth draft of the Apple CD ROM SCSI Command Set. It is a 
complete SCSI command set for the Apple CD ROM product. This command set may or may not 
be released as section 2.5 of the Apple SCSI Command Protocol specification (062-2075). If this 
command set is not released as section 2.5 of the Apple SCSI Command Protocol specification, 
then sections of that specification other than the SCSI command set are also applied to the Apple CD 
rae — Electrical characteristics of the Apple SCSI bus can be found in Apple specification 
0 4 
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2.5 C.D.ROM Commands 


ired. If the initiator does not respond to the reselection ( 
within a Selection Timeout Delay(250ms), the target shall release the bus for 
200ms and then try to rearbitrate and reselect again. The target shall try the above 
disconnect/reselect procedure until the initiator responds or the target receives an 
abort or bus reset message from the reselecting initiator or a hard reset from the 
SCSI bus. The target will respond to selection from the same or other initiators 
between reselection retries. 


Disconnect/reselect is also required for audio commands. If the host chooses to use the 
disconnect/reselect feature, the drive will disconnect only for those operations that involve 
movement of the optical pickup (i.e. during seek). After the target address is found, the drive will 
play audio from that target address and reselect the host at the beginning of the audio play or audio 
scan. Since the reselection process depends on whether the SCSI bus or the host is busy, it is 
alee the audio play or audio scan operation begins before the reselection process is 
comple 
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2.5.1 Group 0 Commands for C.D. ROM Devices The Group 0 commands for C.D. 
ROM devices shall be as shown in Table 2.5.1-1. 
ges Table 2.5.1-1 
Group 0 Commands for C.D. ROM Devices 


b nsseoeedpesninetproe-eretinsnsieepsnsicedfersovamananrseraliuinnrjrmaneseebmamarersipietereatiassiniponatnuestpnasesunsteesvbsetlpsseonfesin-ijunbharantGuan se irsseesdjrasa Var ralraseissipaovrsiGpast agen Srnejrrn/mibal ites ewrapinnsbosenrveersandaaranised pivinsintmntaetagpsiairdalpssasteangennmuandbensmnaaedememndaeannencauns ia dcureessea cae cee Te 
LEAS AS A ST Le aS eT a Se TS ae Slits Gail ann eNPaaie Sailliwa>aaNEP OS Sbae eiulunaniea ieee ameee Meee eee tee ee eee, 


Operation 
Code Type Command Name Section 

O07 M TEST UNIT READY Tele 
Oly M REZERO UNIT 8.1.1 
024 R 
03747 M REQUEST SENSE 7.1.2 
044; R 
OStz R 
O64; R 
O7 fy R 
O87 M READ 12.1.1 
O9p; R 
OAH R 
OBy M SEEK 8.1.6 
OCH R 
ODy R 
OEY R 
OF y R 
1047 R 
lly R 
12H M INQUIRY Tehso 
13H R 
l4yy R | 
15y M MODE SELECT 12-153 
16py M RESERVE UNIT 8.1.8 
1747 M RELEASE UNIT 8.1.9 
187 R 
19yy R 
LAW M MODE SENSE 12.1.4 
IBY M START/STOP UNIT 8.1.11 
1CHy M RECEIVE DIAGNOSTIC RESULTS 7.1.5 
IDy M SEND DIAGNOSTIC | 7.1.6 
LEY M _PREVENT/ALLOW MEDIA REMOVAL 8.1.12 
lFy R 


Key: M = Command implementation is Mandatory. 
O = Command implementation is Optional. 
R = Command code is reserved for future standardization. 


7.1.1 TEST UNIT READY Command 
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Peripheral Device Type: C.D.ROM 


Operation Code Type: | Mandatory ” | 


Operation Code: 


The TEST UNIT READY command provides a means to determine if the C.D. ROM is powered 
up and ready for operation, and a disc is mounted. Refer to section 7.1.1 of the ANSI 
X3T9.2/82-2 Rev. 17B for details. 


8.1.1  REZERO UNIT Command 
Peripheral Device Type: C.D. ROM 
Operation Code Type: Mandatory 
Operation Code: Oly 


Table 8-2 


REZERO UNIT Command 

Bit! 7 | 6 #7 «5 +#s| 4 +' 3 ' 2 «1 *D | O07 
Byte | ! | | | | | | | 

0 | Operation Code OY 
“a "Topical Unit Number — ——° 
~~. ee ema: | 
37 a ee? 
os ae ——— ee 
“s Vendor Unie | Reserved | Flag | Link = 


eg te eae a ie ee a ease aes See asad | 


ec nnimiaiiintineuntitdtientiatiionamelll 


The REZERO UNIT command (Table 8-2) repositions the drive's optical pickup to the starting 
address of the disk and enters the HOLD TRACK state for the duration of inactivity ime. The drive 
will spin up if it is not spinning. 


If the initiator requests disconnect, disconnect will be performed before the seek operation and 
reselect will take place following the seek operation. 


This command should not change the mode select parameters. 
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7.1.2 REQUEST SENSE Command 


Peripheral Device Type: C.D. ROM 
Operation Code Type: Mandatory 
Operation Code: 034 


Extended Sense Data format is Required. 


Implementation of the additional sense code (byte 12) is required and the additional sense code of 
medium change (28H) is mandatory. 


The thirteen(13) first bytes of the Extended Format, as defined in the SCSI specifications, are to be 
supported by the target. All additional bytes are optional. 


EXTENDED SENSE DATA 
The following bytes are REQUIRED 


Valid | Error Class=7H | Error Code=0H 


FM=0 EOM=0IILI=0! R | Sense Key 

Information Byte (MSB) 

Information Byte 

Information Byte 

Information Byte(LSB) 

Additional Sense Length (n) 

Optional, except for use with SEARCH and COPY (00H) 
through commands as per 7.1.4.2 (00H) 


(OOH) 
Additional Sense Code 


CONN AR WN © 


ps pt 
Ne 


The following bytes are optional and follow the Required Extended Sense Data 


byte 12. 
Bit 7 | 6 | 5 | 4 I 3 | 2 | l | 0 
Byte | | | | | | | 
13 Reserved 
14 FRU failed 
15 FPV | CD ! VU | VU! BPV | Bit Pointer 
16 Field Pointer (MSB) 
17 t rT] (LSB) 
18- N/A 
n+17 


Beem 5 


The information bytes are not defined if the Valid (address valid) bit is zero. If this bit is one, the 
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information bytes contain the unsigned logical block address associated with the sense key. 
The FM (File Mark) and the EOM (End Of Media) bit are set to zero. 


The ILI (incorrect length indicator) bit indicates that the requested logical block length did not 
match the logical block length of the data on the medium. This bit is set to zero. 


The Sense Key codes of 0H, 1H, 2H, 3H, 4H, SH, 6H and BH are required. The definition of 
the sense key code is described in Table 7-6 of the ANSI X3T9.2/82-2 Rev. 17B. 


The additional sense length specifies the number of additional sense bytes to follow. If the 
allocation length of the command descriptor block is too small to transfer all of the additional sense 
bytes, the additional sense length is not adjusted to reflect the truncation. 


Byte 12 Additional Sense code. 
The Additional Sense code OO}, indicates that the target does not support any additional sense code 


for the related Sense Key or does not have any appropriate additional sense to return for the Check 
Condition status that it created. 
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C.D.ROM DEVICES ADDITIONAL SENSE CODES (byte 12) 


Code Related Sense Keys 

00 No Additional Sense Information No Sense 

01 Reserved 

02 Error occurred during seek operation. Hardware error or 
Medium error 

03 Reserved 

04 Drive Not Ready (i.e. unit off line in multiple LUN system) Not Ready 

05 Reserved 

06 Reserved 

07 Reserved 

03 Logical Unit Communication Failure Hardware error 

09 Track servo error Hardware error 


OA through OF Reserved 


10 Reserved 

11 L-ECC uncorrectable data error (L-ECC on) Medium error 

12 through 16 ~—— Reserved 

17 CIRC recovered data error (L-ECC off) Recovered error 

18 L-ECC recovered data error (L-ECC on) Recovered error 

19 Reserved 

1A Reserved 

1B Reserved 

1C Reserved 

1D Reserved 

1E Reserved 

1F Reserved 

20 Invalid Command Operation Code legal Request 

21 Dlegal Logical Block Address Illegal Request 

22 Illegal function for device type Hlegal Request 

23 Reserved 

24 Illegal field in CDB other than op-code or illegal logical block address 

Illegal Request 

25 Invalid logical unit number Tegal Request 

26 Invalid field in Parameter List legal Request 

27 Reserved 

28 Medium changed (detected by cartridge insertion) Unit Attention 

29 Power On, Reset or Bus Device Reset occured Unit Attention’ 

2A Mode Select Parameters changed Unit Attention 

2B through 2F Reserved 

30 Reserved Medium error 

31 Reserved 

32 Reserved 

33 through 3F = Reserved 

40 SCSI controler data buffer failure Hardware exror 

41 Drive's internal bus data path failure Hardware error 

42 Power On Diagnostic Failure ° Hardware error 

43 Message Reject Error (see 5.6.1.5) Hardware error or 

: Aborted command 

f 44 ' [Internal Controller Error (see 5.6.1.8) Hardware error 
\ 45 Reselect failed (see 5.6.1.7.) Hardware error 
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46 Reserved 

47 SCSI Interface Parity Error (see 5.6.1.) Hardware error 

48 Initiator Detected Error (see 5.6.1.4) Hardware error or 
Aborted command 

49 Inappropriate/Illegal Message Hardware error or 
Aborted command 

4A through 4F Reserved 

50 through SF _—— Reserved 

60 through 6F = Reserved 

70 through 7F _— Reserved 

80 Prevent Medium Removal Set egal Request 

81 Logical unit is reserved | Tegal Request 

82 End of user area encountered on this track(only for data/audio mode change) Illegal Request 

83 Overlapped commands attempted Absorted Command 

84 Illegal mode for this track (e.g. audio command for data track) Tegal Request 

85 Audio address not valid. legal Request 

86 through 9F ~ = Vendor Unique 

AO through A6 Vendor Unique 

A7 Vendor Unique 

A&8through AF Vendor Unique 

BO No Cartridge in Drive Not Ready 

Bl Unable to recover table of contents(TOC) Not Ready 

B2 Cartridge load/eject failure Not Ready 

B3 CIRC unrecovered data error (L-ECC off) Medium Error 

B4 Focus servo failure Hardware Error 

BS Spindle servo failure Hardware Error © 

B6 Cartridge load mechanism failure Hardware Error 

B7 Read TOC in progress. Not Ready 


B8 through FF Vendor Unique 


Byte 14 Field Replaceable Unit (FRU) failed. A non zero value indicates failure. A value of zero 
means that no FRU is to be reported. 


Byte 15 definition: 
-FPV (Field Pointer Value) Bit 7 of zero indicates that the target does not implement the functions 
supported by C/D & BPV bits and bytes 16 and 17, therefore these bits and fields are not valid. Bit 
FPV of one indicates that the Field Pointer bytes 16 and 17, the C/D and BPV bits are significant. 
-C/D bit of one indicates that the value reported in the Field Pointer is the CDB's byte number for 
which an ILLEGAL REQUEST Sense Key was issued. C/D bit of zero indicates that the value 
reported in the Field Pointer is the byte number of the DATA phase for which an ILLEGAL 
REQUEST Sense Key was issued. 

-Bits 5 and 4 are vendor unique. 

-BPV bit of zero indicates that the target does not implement this function, therefore the Bit Pointer 
field is not valid. BPV bit of one indicates that the Bit Pointer field (bits 0 through 2) is significant. 
-Bits 0 through 2, Bit Pointer, indicates which bit of the byte number reported in bytes 16 and 17 is 
the bit for which the ILLEGAL REQUEST Sense Key was issued. 


een asec Ret pa A Te nao LMC RECTOR NALD EAA, “AO EMT 
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12.1.1 READ Command 


Peripheral Device Type: C.D. ROM 


Operation Code Type: Mandatory 
Operation Code: O08} 


Refer to section 12.1.1 of the ANSI X3T9.2/82-2 Rev.17B for details. The drive will enter a hold 
track state at the completion of the read operation for the duration of the inactivity time. 


8.1.6 SEEK Command 


Peripheral Device Type: C.D.ROM 
Operation Code Type: Mandatory 
Operation Code: OB 


Table 8-12 
SEEK Command 
Bt! 7 | 6 #1 5 +! 4 +! 3 1 2 «1 2 +9 °0 
Byte | | | | | | | | | 
01 Operation Code | 
“Ty Togieal UntNumber TS Logical Block Addess(MSB) SS 
—~: u—<—_ = 
SD Logical Block AddressSB) SSCS 
a. Sera" aes 
“/. Vendor Unique | —< We lime | 


Ee @ awe 0 0 8 OO 8 OO OB © OB BOB BOS FOB C8 6 O98 BOO EOSS 8898 988 8288S B88 B ODODE GSS OES S BSF BEB BEBO BD DDS OD LD DDB LD AD @@ee ee | 
RELA IT EEE OEY DLT TD IEE TTDI TEY ERLE LEE LILLE ELL ELT, STILT 
CE NRE ARDEA RE REED: ELIE LS SELES COLITIS ETE ELEY 


The SEEK command (Table 8-12) requests that the logical unit seek to the specified logical address 
and enters the HOLD TRACK state for the duration of the inactivity time. 
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7.1.3 INQUIRY Command 


Peripheral Device Type: C.D. ROM ( 


Operation Code Type: Mandatory 
Operation Code: 1274 


Bytes 0 through 53 of the Inquiry data are Required. Bytes 54 through the end of 
the data are optional. 


INQUIRY DATA 
Bit 7 6 5 4 3 2 l 0 
| | | | | | | | 
BYTE O Peripheral Device Type (05H) 
BYTE 1 RMB=!1 | Device Type Qualifier ee 
BYTE2 ISO Version | ECMA Version ANSI Version=1H 
BYTE 3 Reserved | ene Data Format=1H 
Response Data Format: — 
Descripuon 

On Vendor Unique 

ly Common Command Set (CCS) 

24 through Fry Reserved 


Targets conforming to at least conformance level 2 as defined in Table El, Appendix E, of the - 
standard, and conforming to this document shall set the Common Command Set code (lq) in 


the Response Data Format field. | 


BYTE 4 Additional Length (n) 
BYTE 5 Vendor Unique 

BYTE 6 and 7 Reserved 

BYTE 8 Vendor Identification (in ASCID 
through "Vendor Name' 

BYTE 15 

BYTE 16 Product Identification (in ASCIT) 
through 'CD-ROM'space' Unique model number assigned for Apple’ 
BYTE 31 

BYTE 32 Revision Level (in ASCII) 
through ‘Firmware revision level’ 

BYTE 35 

BYTE 36 Vendor Unique 

through (Command Bit Map, see explanation below) 
BYTE 55 

BYTE 56 Reserved 

through 

BYTE 97 

BYTE 98 Vendor Unique 

through 

XX 


AAO ERI MAAS NISL ATOLL EL EEE TTA LOI ILE CREEL ITD), ELI ESTE TTT COG ELT EO LET TICES EEL N ENOL LIE TT: GAEL ILL EEE TLE LILO ILE LED OEE LEEDS ITLL EDI LE LES LLP LLLIEL LE LEDOLEE DD, LLL ELE EL IIE ELL 
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Beginning at byte 36 in the VENDOR UNIQUE area of the response are 

extension bytes to-specify the number of extents supported by the RESERVE (command $16) and 
RELEASE (command $17) commands. Following this is a list of SCSI commands supported by 
this device. Commands map into this list by their group code and command code values. Values 
are returned by first specifying a Group Code Specifier (a byte for the Group Code value; 0 for 
Goup 0, 1 for Group 1, etc), then specifying a 4 byte Command Bit Map representing the 
commands implemented within that group. The bit map is constructed by setting a bit for an 
implemented command according to that command's value, and clearing a bit otherwise. Bits 
within the bit map are numbered in ascending order beginning with the first bit following the Group 
Code Specifier. This list is terminated by specifing a $FF for the Group Code (no additional 
command bit map bytes are necessary). | 


Example: The following is an example of the format. 


Byte 36:300 (Hi Order byte - number of Extents] 
Byte 37:300 [Low Order byte -number of Extents] 
Byte 38:$00 [Group 0 commands] 

Byte 39:$D0 [Commands 0H,1H,3H] 

Byte 40:$90 [Commands 8H,BH] 

Byte 41:$27 [Commands 12H,15H,16H,17H] 
Byte 42:$3E 


[Commands 1AH,1BH,1CH,1DH,1EH] 
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Byte 43:501 [Group 01 commands] 

Byte 44:$04 [Command 25H] 

Byte 45:$91 [Commands 28H,2BH,2FH] 

Byte 46:300 [No commands implemented in this range] 
Byte 47:$18 [Commands 3BH,3CH] 

Byte 48:$06 [Group 6 commands] 

Byte 49:$F0O 

[Commands COH,C1H,C2H,C3H] 

Byte 50:$FC [Commands C8H to CDH] 

Byte 51:300 [No commands implemented in this range] 
Byte 52:$00 {No commands implemented in this range] 
Byte 53:SFF [End of list] 
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8.1.7 MODE SELECT Command 


Peripheral Device Type: C.D. ROM 
Operation Code Type: Mandatory 
Operation Code: ISH 
Table 8-13 
MODE SELECT Command 

Bitl 7 | 6 . 2 | 4 | 3 | 2 | 4] | 60 | 
Byte | | | | | | | | | 
0 | Operation Code a | 
anna nnn |e anne nn nnn nnn nn nnn nnn me enn nn nn nn nn nn enn nnn nnn nnn nn nnn nnen nnn nenennnennnerenennne===| 
1 | Logical Unit Number | Reserved | SP=0 | 
------- | --------- = - nn nnn nnn nnn nnn nnn nnn mn nnn nan nnn nnn mn nnn en nnn nnn nnn nn mn nnn nnn nnn wenn nnn no| 
2 4 Reserved | 
------- | enna nnenn nana nnn nnn nnn nnn nnn en nen nnn nnn nen nnn nnn nn nn nnn nnn enn nn new nn ennnnnnennn nen nrnnnnnnnnn---| 
3 | Reserved | 
a aS aa aa tn cre ee | 
4 | Parameter List Length | 
-—----- | -—-- -- 3 nn nn nn nnn nnn nn nnn nm nnn nn nn nn mn nn nn nnn nn nnn nnn nnn nn nnn nnn nne| 
5 | Vendor Unique | Reserved | Flag | Link | 


Mandatory Page Codes for \Vioge select and Vioge sense 


1. Page Code $0: Unit Attention 

2. Page Code $1: Error Recovery Parameters 

3. Page Code $2: Disconnect/Reconnect Control Parameters 
4. Page Code $20: Drive Parameters. 

5. Page Code $3F: Report Values (Mode Sense only) 


The MODE SELECT command (Table 8-13) provides a means for the initiator to specify or 
change medium, logical unit, target or peripheral device parameters to the target. This 
command is Required within the Apple Common Command Set. 


The Parameter List Length specifies the length in bytes of the MODE SELECT parameter list that 
shall be transferred during the DATA OUT phase. A parameter list length of zero indicates that no 
data shall be transferred. This condition shall not be considered an error. 
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The MODE SELECT parameter list (TABLE 8-14) contains a four-byte header, followed by zero or 
one block descriptor, followed by zero or more Pages. 


Table 8-14 
Mode Select Parameter List 
~ Bttl 7 | 6 | 5 | 4 r 2 | 1 to 
Byte | | | | | | | | | 

0 | Reserved | 
Tu Type 
i. —<—_ ne 
"saa Block Descriptor Length (OH @08) SS 

Block Descriptor(s) 

0 | Reserved DO 
i aes Numbe of Blocks MSB) 0H StCtCS<S 
ss aes Numba ofBloks OHSS 7 
Ty Per of Blocks SB) OH 
oe eee ri 
leg MSE) 
6 ene ee Length ——— os 
7 pmomaaseenemceeereenree Block Length is) 

Page Descriptor(s) 

0 | R | R | | Page Code oo 
—~i)0C””S””S« Cee —awmeeennes 
| CC 


The Block Descriptor Length specifies the length in bytes of all the block descriptors. A block 
descriptor length of zero indicates that no block descriptors shall be included in the parameter list. 
This condition shall not be considered an error. The number of blocks field specifies the number of 
logical blocks on the medium that meet the block length in the Block Descriptor. A 00H in all 

the Number of Blocks fields specifies all the logical blocks of the logical unit. 


he- Block Lenoeth specifies the fenetn in vvres OF eacn logical DIOCKS. 
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enetn ¢ realise } Lise PCICILUs J43(8005 IhPACLIZIS 
i 0 ( 40(92< kil i 
JO ELOI A! mls Y) 8 ) he VOLION c av 
: 5 8 e — © 
supported by the target. 
s e 
he initlata he DiocKk lenyetn tc i (Ke mpliemented) bvte 
es a ® M4 af * s 
per DiOcK ang the lavered L.CL napiec dS DIE IS Set to zero). the target 
e 3 es : 
will generate CHECK CONDITION ¢ eoal request for both mode | and mode ? 
e e,8 : : oe ; : e 
lata Diock he Initiator should use Diock jeneth of 0. 4990 OF £50201 
z e 
4 2 fh ohne ENO oe Od DIOCKS..ACCessing mode 
s J e 
0. 4540 OF £504 Implemented) will 


Optional additional blocks of parameters called Pages may be sent to the target in 
the Data Out phase of the MODE SELECT command, following either: 

- the MODE SELECT Header, if the Block Descriptor length is set to zero. 

- or one Block Descriptor. 

The Block Descriptor Length shall not include the length of the Pages. 


Page Definition: 

Each defined Page is preceded by a Header of two bytes defining the Page Code 
and the length of the page. Following the Header, the Pages are separated into 
sub-blocks containing a list of related flags and/or values. 


Bits 7 and 6 of byte 0 are reserved. 


The Page Code identifies the meaning of the following bytes in the Page. The 
Page Code is either defined, reserved or vendor unique. The parameters in the 
defined Pages are classified in priority sequence to ease implementation by the 
target. 


The Page Length value of each defined page, shall not include the Page Length 
byte. The Page Length represents the number of bytes that the target supports in 
each Page. The target may return in the Pages of the MODE SENSE commands as 
many consecutive bytes that it supports, for each Page that it supports, without 
splitting fields of multiple bytes. The Page Length shall be set in the pages of the 
MODE SELECT commands to the exact same value (zero value included) returned 
by the target in the MODE SENSE Page Length bytes. Otherwise, the target shall 
create Check Condition status with the Sense Key of ELEGAL REQUEST. 

The initiator shall issue a MODE SENSE command requesting the target to return 
all Changeable values (see PCF field configuration 01B in byte 2 of the MODE 
SENSE CDB) prior to issuing any MODE SELECT commands, in order to find out 
which Pages are implemented by the target and the length of each Page for that 
particular LUN(Logical Unit Number). 


Initiator Implementor Notes: 

- Those Pages, supported by the target, in which the initiator requests parameters 
to be changed shall be sent to the target. 
- The initiator may send in MODE SELECT commands all Pages supported by the 
target. 

- The Pages are not required to be sent in ascending order. 


In the event of a Hard Reset, the target shall first attempt to restore the Default 
Parameters. 
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ee Meaning _ 
= Unit Attention 

ly Error Recovery parameters 
24 Disconnect/Reconnect Control parameters 
3y through 1Fy Reserved 
20H Drive Parameters. 
21y-2F y, 31y-3EH Vendor Unique Page formats 
3FH Defined in MODE SENSE only. 


The initiator may issue a MODE SELECT command at any time. 


The target may or may not save the block descriptors and Pages for each LUN and 
for each initiator. If the target supports 8 LUNs and the bus configuration 
includes 7 hosts, the target would have to save 56 sets of MODE SELECT/ MODE 
SENSE data. The data for each LUN for each host could be different. 


a MOL CT command js received from an initiate he target snc 
psnond to the next command received (except INOUIRY or REOU 
‘rom all other initiators with a CE 4 CONDITION status, I he sense ke 

yn UNIT ATTENTION and the additional sense code is set to MOD 
PAKAIVE N TAIN 0 he controller will preserve the unit attention 
condition if an INOUIRY or REOU Ne command is received he uni 
antion condition is set upon receipt of the MOD Tl command bv the 
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ATTEN CARI RAS TLE ERE LTE TOTNES SELES: LIAL IGS LLL TILE LEILA CETERA ETI LONG CIOL NEI! CLAIRE EL TRS OLE EEO E EL LEI LL STD STD TS NND GRUN-teD- CES acer 
EE ESE SLE CLINE TEESE BEE GER E IDS ES LEL LP. SEE RE TE GT CIA A EE LN IE RE I SLT IE I PD 


Bit 7 6 5 4 3 2 l 0 
Byte | | | | | | | | 
oO R | R | PageCode=lp 
Page Length (in bytes) 

ys R I! R | TB | RC | EEC | PER |! DTE | DCR 
3 Retry Count 

4 Reserved 

J Reserved 

6 Reserved 


Recovery Time Limit = 00H 
NOTE: In the event of a conflict between the bit definitions and the error recovery procedures 
defined on pages 19 and 20, the error recovery procedures take precedence. 


A DCR (Disable Correction) bit 0 set to one indicates that the data shall be transferred without 
applying error correction (layered ECC). A DCR bit set to zero enables error correction 
(layered ECC). it j ; 


A DTE (Disable Transfer on Error) bit 1 set to one and if the PER bit is set to one, indicates 
that the target shall create the Check Condition status and terminate the data transfer to the initiator 
immediately upon detection of an error. The Transfer Length is then not exhausted. The data of the 
block in error, which is the first erring block encountered, may or may not be transferred to the 
initiator depending upon the setting of the TB bit. The DTE bit can only be set to one by the 
initiator if the PER bit is set to one. The target shall create the Check Condition status with Illegal 
Request Sense Key, if it receives PER bit of zero and DTE bit set to one. 

A DTE bit set to zero enables data transfer for any data which can be recovered within the limits of 
the Error Recovery Flags. Any erring block that would be posted, which is the last recovered block 
encountered, is not posted until the Transfer Length is exhausted. 


The DTE bit is default t for C.D. ROM. 


A PER (Post Error) bit 2 set to one indicates that the target shall enable the reporting of the 
Check Condition status for recovered errors, with the appropriate Sense Key. The Check 
Condition shall happen during the data transfer depending either on the DTE bit value or if an 
unrecoverable error occured. If multiple errors occur, the REQUEST SENSE data shall report the 


block address of either the last block on which recovered error occured or of the first unrecoverable | 


error. 
A PER bit set to zero indicates that the target shall not create the Check Condition status for errors 
recovered within the limits established by the other Error Recovery Flags. Recovery procedures 
exceeding the limits established by the other Error Recovery Flags shall be posted accordingly by 
the target. The transfer of data may terminate prior to exhausting the Transfer Length depending on 
the error and the state of the other Error Recovery Flags. 


An EEC (Enable Early Correction) bit 3 set to one indicates that the target shall enable the use 
of the most expedient form of error recovery, such as error correction, before applying retries. 

Seek or positioning retries and the recovery procedure retries of the message system are not affected 
by the value of this bit. Targets implementing error correction schemes that do not provide the most 
expedient form of error recovery should default to zero and report the EEC bit as not changeable in 
the MODE SENSE Page code 3. EEC and DCR both of one is an invalid request, for which the 
target shall create the Check Condition status with Dlegal Request Sense Key. 
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An EEC bit set to zero, indicates that the target shall exhaust the defined retry limit prior to enabling 
error correction. If DCR bit is set to one, the defined retry limit only is to be performed. 


The ECC bit is default t | 


A RC (Read Continuous) bit 4 set to one requests the target to transfer the entire requested 
length of data without adding delays that would increase or ensure data integrity (ie. delays caused 
by the target's error recovery schemes). This implies that the target may send data which may be 
erroneous or fabricated in order to maintain a continuous flow of data and avoid delays. 

The target shall assign priority to this bit over conflicting error control bits EEC, DCR, DTE, PER) 
A RC bit set to zero, indicates that error recovery operations which cause reasonable delays are 
acceptable during the data transfer. Data shall not be fabricated. 


@e,e : 
NWOTtTe tnar Apple na ne AGGIVON. {) seared Tat UCic eS emels t, JEL W ECT 


A TB(Transfer Block) bit 5 set to one indicates that the failing data block (recovered or 
unrecoverable) data shall be transferred to the initiator. A TB bit set to zero indicates that the failing 
data block (recovered or unrecoverable) data shall not be transferred to the initiator. 

Implementor Note: In both cases, but particularly when TB is zero, the block address reported in 
the REQUEST SENSE data shall be of the erring block, not of the preceding block. 


The TB bit is default | 


The following table summarizes all valid modes of operation. 


Value Error Recovery Byte Bit Settings 


|Reserved |Reserved! TB I|Reseved | EEC | PER |! DTE | DCR |! 
| | | | | | | | | 


00 | | | QO | | oO | 0 | Oo J! 0 | 
on: ot | ro | 1 0 1 0 1 0 1 11 
7, OD 
6 1 |. or ft O | 1 1 0 1 1 4 
6: it ¢ 01. 1 0 + tt 2 1 0 1 
rot ¢ O | 2 to to 1 a4 
20 | #+| ft tt tt 0 + 0 1 0 1 0 4% 
mn | | Jt dt t 0 + Ot O 1 19 
6 1 it it 1 | ¢ 0 1 2 1 2 4 0 4 
el roadot ¢ 0 1 2 do tod 
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The following are the definitions of the errors reported by the C.D. ROM. 


1) CIRC recovered data error: This error is defined as a data block for which the C2 flag was set, ( 
but on a subsequent read retry operations it was not set. The number of the subsequent read 
operations is limited to the read retry count (Byte 3 of the error recovery parameters page). 

L-ECC is not used in this case. 


2) CIRC unrecovered data error: This error is defined as a data block for which the C2 flag was set 
on all read operation up to the read retry count. L-ECC is not used in this case. 


3) L-ECC recovered data error: This error is defined as a data block for which C2 are asserted but 
the layered ECC was able to correct the error within the read retry count. 


4) L-ECC uncorrectable data error: This error is defined as a data block which could not be 
corrected by the layered ECC within the read retry count. 


Ketry Cour ne number of hmes that the tareet should attempt its read recovery aleorithm 
Ording the sethne of the DCR 6 ne Dit that enapnle/disable L- , i 


Recovery Time Limit is the maximum time that the target shall attempt error recovery actions to 
recover data. A zero value indicates that the time is unlimited. The Recovery Time Limit is set to 
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* 7 * * ae i a * 
Or reco y procedures for the U.V. ROM Mode | data block 


This is the default value of the error recovery byte. L-ECC ison. Only L-ECC 

uncorreciable Gata errors are reported. If an uncorrectable data error occurs, data 

te-lenidss LLCO Gt It, De iiitis Ol le Titst Clic Ou?}l Te UIC OLIe @§0 

block with a CHECK CONDITION status. The sense key is set to MEDIUM 

ERROR and the additional sense code is set to L-ECC UNCORRECTABLE 

DATA ERROR. The information bytes in the REQUEST SENSE command are 
’ get to the address of the first encountered uncorrectable block address. 


04H L-ECC ison. L-RCC recovered data block errors are reported. niyehetainoe 


lata bIOCK in dine recovered gata DiocK) are transtrerrec to tne 
initiator. After the data ranier | is completed, a CHECK CONDITION status is 
reported. The sense key is set to RECOVERED ERROR and the additional 
sense code is set to L-ECC RECOVERED DATA ERROR. The information 
bytes are set to the address of the last block for which an L-ECC recovered data 
error was detected. If an L-ECC uncorrectable data error occurs, data transfer is 
not terminated until all requested data blocks (including the L-ECC uncorrectable 
data block) are transferred to the ininator. After the data transfer is completed, a 
CHECK CONDITION status is reported. The sense key is set to MEDIUM 
ERROR and the additional sense code is set to L-ECC UNCORRECTABLE 
ERROR. The information bytes are set to the address of the last block for which 
an L-ECC uncorrectable error was detected. 


06H L-ECC ison. L-ECC recovered data errors are reported. If a L-ECC recovered 


data error occurs, 

encountered L-ECC recovered data block with a CHECK CONDITION status. 
The sense key is set to RECOVERED ERROR and the additional sense code is 
set to L-ECC RECOVERED DATA ERROR. The information bytes are set to 
the address of the first encountered L-ECC recovered error block. If an L-ECC 
uncorrectable data error occurs, data transfer is terminated at the beginning of the 
first encountered L-ECC uncorrectable data block with a CHECK CONDITION 
status. The sense key is set to MEDIUM ERROR and the additional sense code 
is set to L-ECC UNCORRECTABLE ERROR. The information bytes are set to 
the address of the first encountered L-ECC uncorrectable block. 


26H L-ECCison L-ECC recovered data crrors-arereported This setting has the 
ame function as the setting of 06H excen recovered OF an 


Arst encountered L- recovered or L- rcorrectable data block with a 


CHECK CONDITION stamus. 


20H L-ECC ison. Only L-ECC uncorrected data error are reported. If an L-ECC 
uncorrectable data mon error re 
inié StICU Udida UMA.K dine = NCO Die Udid UUs 
transferred to the initiator. After tie data transfer has completed, a CHECK 
CONDITION status is reported. The sense key is set to MEDIUM ERROR and 
tha additional sense code is set to L-ECC UNCORRECTABLE ERROR. The 
information bytes are set to the address of the last block for which an L-ECC 
uncorrectable data error was detected. 
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recovery procedures for the 2, Vode J and Mode 2 data block 


CONDITION stata. The sense key i is set to MEDIUM ERROR and the 
additional sense code is set to CIRC UNRECOVERED DATA ERROR. The 
information bytes are set to the address of the first encountered CIRC 
unrecovered block address. 


requested data Dock ding he CIR recovered data block) are tran: =C 
to the initiator. After fie data transfer is completed, a CHECK CONDITION 
status is reported. The sense key is set to RECOVERED ERROR and the 
additional sense code is set to CIRC RECOVERED DATA ERROR. The 
information bytes are set to the address of the last block for which an CIRC 
recovered data error was detected. If a CIRC unrecoverable data error occurs, 
data transfer is not terminated until all requested data blocks (including the CIRC 
unrecovered data block) are transferred to the initiator. The sense key is set to 
MEDIUM ERROR and the additional sense code is set to CIRC 
UNRECOVERED DATA ERROR. The information bytes are set to the address 
of the last encountered CIRC unrecovered block. 


L-ECC isnotused. CIRC recovered data errors are reported. po rte 


recovered data error peat 

with a CHECK SSRN 
status. The sense key is set a RECOVERED ERROR and the additional sense 
code is set to CIRC RECOVERED DATA ERROR. The information bytes are 
set to the address of the first encountered CIRC recovered error block. If an 
CIRC unrecovered data error occurs, data transfer is terminated at the beginning 
of the first encountered CIRC unrecovered data block with a CHECK 
CONDITION status. The sense key is set to MEDIUM ERROR and the 
additional sense code is set to CIRC UNRECOVERED ERROR. The 
information bytes are set to the address of the first encountered CIRC 
unrecovered block. 


L-ECC is notused. CIR 


he same function as the setting of 07H excent that if a CIRC recovered or CIRC 


Intil ¢ fequested data DIOCKS ir ding th CIR .UnTec overed data DIOCK) are 

to t tor. After the data transfer has completed, a CHECK 
CONDITION starus is s reported. The sense key is set to MEDIUM ERROR and 
tha additional sense code is set to CIRC UNRECOVERED ERROR. The 
information bytes are set to the address of the last block for which an CIRC 
unrecovered data error was detected. 
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DISCONNECT/RECONNECT CONTROL PARAMETERS. Page code 247 


Bit 7 6 5 4 3 2 1 0 
| | | _ | | bo 


ea terarenderecmereneeesgeeenenf evnovapues-ardhmrasungpensungeers.sieandinipesaeaqerranatrewangren apa: oeugennnegremmaeesnesamresttjimerebuasspereegieerertpereca enceneerreroereanrenerene eee ee a a TEE 
eb SCRA LEE ATELIER AD NEED I I IE EL LEE EE AIOE EE EY LOS AOE LO CESARE ha enadenereenipmenantpourre 


to 
<< 
& 


Page Code = 277 
Page Length (in bytes) 
Buffer Full Ratio 
Reserved 
Bus Inactivity Limit (MSB) 
Bus Inactivity Limit (LSB) 
Disconnect Time Limit (MSB) 
Disconnect Time Limit (LSB) 
Connect Time Limit (MSB) 
Connect Time Limit (LSB) 
0 Reserved 
l Reserved 


—r- Ooo~rnnMaAhi WN © 


Each ratio parameter is the numerator of a fractional multiplier that has 256 as its 
denominator. 


Buffer Full Ratio indicates to the target, on READ commands, how full the buffer shall be prior 
to reconnecting. 


The default value of the Buffer Full Ratio is 08H. 
The relationship between the values of the buffer full rano and the number of blocks are specified 


below. 

Value Number of Number of 
of Buffer 2048 2336/2340 
Full Ratio byte blocks byte blocks 
OOH. 32 28 
01H - 08H l l 

09H - 10H 2 pi) 

11H - 18H 3 3 

19H - 20H 4 4 

21H - 28H 5 5 

29H - 30H 6 6 

31H - 38H 7 7 

39H - 40H 8 8 

41H - 48H 9 8 

49H - 50H 10 9 

51H - 58H 11 10 
59H - 60H 12 11 
61H - 68H 13 12 
69H - 70H 14 14 
71H - 78H 15 14 
79H - 80H 16 15 
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Value 
of Buffer 
Full Rano 


81H - 88H 

89H - 90H 

91H - 98H 

99H - AOH 
AlH - A8H 
A9H - BOH 
B1H - B8H 
B9H - COH 
C1H - C8H 
C9H - DOH 
D1H - D8H 
D9H - EOH 
E1H - E8H 
E9H - FOH 
F1H - F8H 

FOH - FFH 
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Bus Inactivity Limit field (bytes 4 and 5) indicates the maximum time in 100 microseconds oie 
increments that thé target is allowed to maintain the bus busy without handshakes until it shall ( 
disconnect. The target may round to its nearest capable value. A setting value of zero indicates that _ 
' the target is allowed to maintain the bus busy indefinitely without handshakes until it determines to 
disconnect. The default value for the Bus Inactivity Limit field is 00H. 


Disconnect Time Limit field (bytes 6 and 7) indicates the minimum time in 100 microseconds 
increments that the target should remain disconnected until it attempts to reconnect. The target may 
round to its nearest capable value. A setting value of zero indicates that the target is allowed to 
reconnect immediately. The default value for Disconnect Time Limit field is 00H. 


Connect Time Limit field (bytes 8 and 9) indicates the maximum time in 100 microseconds 
increments that the target should remain connected until it attempts to disconnect. The target may 
round to its nearest capable value. A setting value of zero indicates that the target is allowed to 
remain connected indefinitely until it determines to attempt disconnection. The default value for 
Connect Time Limit field is 00H. 
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Cr ene we connor caer iaa saunanienraennadeensanapaseesetipeamysitpricssesigeinaneentenenmetgienedanapsoienindsienssiuanetetpanettgenantgtnonandgsieaiseaierewseignanecstemeniaheciueadpanavceigrateiesteenionigmmmnbtemiansabaneangunsieaapenuaatapettakacaneeene terete 
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Bit 7 6 4 3 l 0 
Byte | | | | | | | | 

Oo R IR | PageCode=207.—“(i‘(<i< O!”*~C~*# 

l Page Length (in bytes) = 02H 

2 Rsvd. | Rsvd. | Rsvd. | Rsvd. | Rsvd. | Rsvd | Rsvd | Rsvd 

3 Reserved | Inactivity Time-Out 


The Inactivity Time-Out byte is used by the initiator to set the time-out value to 
spin-down the medium and turn off the laser when the drive is inactive (for both 
data and audio operation). The drive will remain in the hold track state after 
completion of a seek or read operation during the inactivity time-out period. The 
time-out value is the value of this 4-bit field times 2 minutes. A 0H in this field 


will turn on the drive infinitely. Vv : 
is. 3 y7-which mear he drive wi rn off in approximate ) minutes from the 
ime when the drive enters 2 hold track state following a seek or read oneratior 
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8.1.8 RESERVE UNIT Command 


Peripheral Device Type: C.D. ROM 
Operation Code Type: Mandatory 
Operation Code: 16,7 


Table 8-15 
RESERVE UNIT Commands 
Btl 7 | 6 | 5 | 4 | 3 | 2 | 2 | Of 
Byte | | | | | | | | | 
0 | Operation Code ——- | 
“T" Logical Unit Number” | SrdPany | Third Pay device ID) Een 1 
s ane eae cee ee erererennreneeneetanomnanrouy 
—~ eee 
<i eee rns 
“S| Vendor Unique 1 Reserved SOS™S*~*~*~*~*~*~SYSQage ink 


RESERVE UNIT Command. The RESERVE UNIT command (Table 8-15) is used to reserve 
the specified logical unit for the exclusive use by the requesting initiator or, if the third-party 
reservation is requested, to another specified SCSI device. The implementation of the EXTENT bit 
; mea 


The reservation shall remain in effect until superceded by another RESERVE UNIT command from 
the initiator that made the reservation or uintil released by a RELEASE UNIT command from the 
same initiator, ora BUS DEVICE RESET message from any initiator, or a "hard" RESET 
condition. The occurance of the last two conditions is indicated by a sense key of UNIT 
ATTENTION on the next command following the condition. It is not an error to issue this 
command to a logical unit that is currently reserved to the requesting initiator. 


If the logical unit is previously reserved by another initiator, then the target shall return a 
RESERVATION CONFLICT status. 


If, after honoring the reservation, any other initiator then subsequently attempts to perform any 
command on the reserved logical unit other than a RESERVE UNIT command, or a RELEASE 
UNIT command(which shall be ignored), then the command shall be rejected with a 
RESERVATION CONFLICT status. 


The third-party reservation for the RESERVE UNIT command allows an initiator to reserve a 
logical unit for another SCSI device(initiator). This is intended for use in multiple-initiator systems. 


If the third-party (3rdParty) bit is zero, then third-party reservation is not requested. If the 3rdParty 
bit is one, then the RESERVE UNIT command shall reserve the specified C.D. ROM unit for the 
SCSI device specified in the third-party device ID field. The target shall preserve the reservation 
until superceded by another RESERVE UNIT command from the initiator that made the reservation 
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or until released by the same inidator, by a BUS DEVICE RESET message from any initiator, or by 
a "hard" RESET eondition. The target shall ignore (i.e., return GOOD status) any attempt made by 
any other initiator to release the reservation. : 


An initiator that holds a current reservation may modify that reservation (e.g., switch third-parties) 
by issuing another RESERVE UNIT command to the same logical unit (C.D. ROM). The 
superceding RESERVE UNIT command shall release the previous reservation state only when the 
new reservation is granted. 
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8.1.9 RELEASE UNIT Command. 


Peripheral Device Type: C.D. ROM 
Operation Code Type: Mandatory 
Operation Code: 17 
Table 8-17 


RELEASE UNIT Commands 


Bt! 7 | 6 | 5 | 4 | 3 | 2 | bt tO 4 
Byte | | | | | | | | | 

0 | Operation Code | 
a Topical Unis Number Gray "Third Pany device ID | Reserved | 
Eee —_  —'* 
ce enim 
— — —" 
5. eerner nena “ys Raced ~~SCOt*~“‘—sé~<STSRgsSC ke 


The RELEASE UNIT Command (Table 8-17) is used to release the logical unit if it is currently (— 
reserved by the requesting initiator. 


It is not an error to attempt to release a logical unit that is not currently reserved to the requesting 
initiator. However, it shall not be released if it is reserved by another initiator. 


The third-party release for the RELEASE UNIT command allows an initiator to release a logical unit 
that was previously reserved using the third-party reservation option (see 8.1.8). 


If the third-party (3rdParty) bit is zero then the third-party release option is not requested. If the 
third-party bit is one, then the target shall release the specified logical unit, but only if the 
reservation was made using third-party reservation by the initiator that is requesting the release and 
for the same SCSI device as specified in the third-party device ID field. 
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8.1.10 MODE SENSE Command 


Peripheral Device Type: C.D. ROM 
Operation Code Type: Mandatory 
Operation Code: LAY 
Table 8-18 
MODE SENSE Command 

Brl 7 | 6 | 5 | 4 | 3 | 2 | dt tof 
Byte | | | | | | | | | 
Oo: | Operation Code™” 4 
bends i a a a as ee ce ee eee 
1 | Logical Unit Number | Reserved | | 
sees eas ea a a ee 
2 | PCF | Page Code | 
-—----- S| 
3 | Reserved | 
------- | owen ann nn nnn a nnn nn nn nnn nnn en nnn nn nnn enn n nnn nnn a nn men enn nnn nnn ween nme nnn nn nnn nnn nn nnn nw nnn een noe =| 
4 : Allocation Length | 
Eee a PND Ne CoN A PRO TT aT mea ee oe er a ee REE Ee Se a EE Oe OE | 
5 | VU Reserved | Flag | Link | 


The MODE SENSE command (Table 8-18) provides a means for a target to report its medium, 
logical unit, or peripheral device parameters to the initiator. It is a complementary command to the 
MODE SELECT command (see 8.1.7). 


The PCF (Page Control Field) bits 7 and 6 of byte 2 defines the type of Page 
Parameter values to be returned. 


B(7)B(6) 
00 Current Values 
O1 Changeable Values 
10 Default Values 
11 Default Values 
; ROW not writab yarame Ss can not O q. A 


Current Values 
The current values returned are either the parameters set in the last sucessful MODE SELECT 
command or the default values if a MODE SELECT command has not been executed. 


Changeable Values 

The pages requested will be returned with the bits that are allowed to be changed set to one. 
Parameters that are not changeable will be set to zero. If any part of a field is changeable, all bits in 
that field are set to one. 

The page descriptor as defined in this document will always be returned even if none of the 
parameters are changeable within the page. 
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Pages requested will be returned to the initiator with the fields or bits set to the default values. ( 
Fields and bits not supported by the target shall be set to zero. \ 


The Page Code bits 5 through 0 of byte 2 indicates which Page(s) to return. If the 
page code is 3FH, all implemented pages are requested to be returned by the 
target. 


Page Codes (bits 0 through 5 of byte 2) 


Fase Code Meaning _— 

H Unit Attention 

ly Error Recovery parameters 

2H | Disconnect/Reconnect Control parameters 
204 Drive Parameters 

3FH Return all Pages to the initiator. 


The allocation length specifies the number of bytes that the initiator has allocated for returned 
MODE SENSE data. An allocation length of zero indicates that no MODE SENSE data shall be 
transferred. This condition shall not be considered as an error. Any other value indicates the 
maximum number of bytes that shall be transferred. The target shall terminate the DATA IN phase 
when allocation length bytes have been transferred or when all available MODE SENSE data have 
been transferred to the initiator, whichever is less. 


The MODE SENSE data (Table 8-19) contains a four-byte header, followed by one eight-byte block 


descriptors, followed by zero or more Pages. a 
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_ | Table 8-19 

MODE SENSE Data 
no o>? | hkl hel slum ShlUU Ud OU 
Byte | | | | | | | | 
Os 
— MeduaTypeQ0HC 7 
a aoe aaa SkDeaipxliagh-GH CC 
0 | a as 
ei a 85) 
2 + Number of Blocks | 
EL ais! 
=e —<. 7 
ee 
6 | Block Length | 
ee Lase~C~SC:*=‘“‘“SC:t;‘“‘“‘i‘=~‘S 

Page Descriptor(s) 
01 PSO 1R |. Page Code — 
saa ia °° °° ¢ 
— Refer to Page definition in MODE SELECT 


The Sense Data Length byte specifies the length in bytes of the following MODE SENSE data that 
is available to be transferred during the DATA IN phase. The Sense Data Length byte shall not 
include itself. If the Allocation Length of the CDB is too small to transfer all the 

sense data, the Sense Data Length shall not be adjusted to reflect the truncation. 


WP (Write Protected) bit i for C.D. ROM 
The block descriptor length specifies the length in bytes of one block descriptor, therefore this field 
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should be set to 08H. 


The number of blocks field specifies the number of logical blocks on the medium that meet the 


block length in thé Block Descriptor. A.0OH in all the number of blocks fields specifies ( 
»vtes of each logical blocks, Block Length o 6(100H), 512(2008 
1024(400H), 2048(800H), 2052(804H., ontional). 2336(920H) .2340(924H), o} 


Pages are returned following zero or one block descriptor if requested. Each page has a header 
defining the page code and the page length. Following the header are page parameters. The page - 
length value is the number of bytes that follow the page length byte and does not include the 
header. The pages are defined under the MODE SELECT command. 


The initiator shall issue a MODE SENSE command requesting the target to return all Changeable 
values (PCF field configuration 01B and Page Code 3FH in byte 2 of the MODE SENSE CDB) 
prior to issuing any MODE SELECT commands, in order to find out which Pages are implemented 
by the target and the length of each Pages for that particular target. 


An initiator may request a particular Page to be returned by the target by selecting its code in byte 2 
of the CDB. 


8.1.11 START/STOP UNIT Command. 
Peripheral Device Type: C.D. ROM 
Operation Code Type: Mandatory 
Operation Code: IBY 
Table 8-20 
START/STOP UNIT Command 
Bit! 7 | 66 | § | 4 | 3 | 2 | 1 | 0 | 
Byte | | | | | | | | 
0 | Operation Code | 
waeeece [onan nnn nnn nnn nnn ne nnn enn nnn wanna enn nnn nn n- enn nnn nn = w= == == == == === --| 
1 | Logical Unit Number | Reserved lImmed | 
weceenn [enna meena nnn nn nn nnn nnn en nn nnn nnn nnn nnn nn nnn nn nnn nn nnn nn nen nn enn ee nnn mene nnn en nneeennweren nnn a=| 
2 | | Reserved ; 
3 | Reserved : 
hic ct a a a a at ee cea 
4 | Reserved | | Start ’ 
guneics a eae Pe NCE Re Pe Se NS IY ELE NOTA Re AE CREE Re One Cer Ce ener see ee 
5 | Vendor Unique | Reserved | Flag | Link | 
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The START/STOP UNIT Command (Table 8-20) requests that the a enable or disable the 
logical unit for further operation. 


An immediate (Immed) bit of one indicates that the status shall be returned as soon as the operation 
is initiated. An Immed bit of zero indicates that status shall be returned after the operations. If the 
Immediate bit is zero and the initiator rn disconnect/reconnect, the command will disconnect 
while performing the command. 


A start bit of one requests the logical unit be made ready for use (i.e. the drive will spun up and the 
laser beam, focus servo and tracking servo are put into on state). A start bit of zero requests that the 


logical unit be stopped (i.e. the drive will spun down and the laser beam, focus servo and tracking 
servo are put into off state). 
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7.1.5 RECEIVE DIAGNOST IC RESULTS Command. 


Peripheral Device Type: C.D. ROM ( | 
Operation Code Type: Mandatory 
Operation Code: 1CH 
Table 7-18 


RECEIVE DIAGNOSTIC RESULTS Command 


Bit! 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 | 
Byte | | | | | | | | | 
7, Operation GodeSSt~CS 
La i  «4«eae— <a 4 
? ls ———a——_ 
oe ee 
~~ ——=- i i—_ °.4z,x« tus 


The RECEIVE DIAGNOSTIC RESULTS Command (Table 7-18) requests analysis data be sent to 
the initiator after completion of a SEND DIAGNOSTIC command. ( 7 


The allocation length shall specify the number of bytes that the initiator has allocated for returned 
diagnostic data. An allocation length of zero indicates that no diagnostic data shall be transferred. 
Any other value indicates the maximum number of bytes that shall be tranferred. The target 
terminates the DATA IN phase when allocation length bytes have been transferred or when all 
available diagnostic data have been transferred to the initiator, whichever is less. 
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The RECEIVE DIAGNOSTIC data contains an eight-byte parameter list defined as follows. 


Table 7-18-1 
Receive Diagnostic Data 


ALS ERT EELS) LLL IE LOO EELELLELS GSE EAL LE ALAR SPIELE RE LEELA LE LLL EDAD LEELA LL ALLELE LAGE BELLE DNL. LEE ITE LLL) LOLI LG TINIE! SELEY ALD LIP SELES ALE SERENE TTL "EERE RETREATED ELS CLES ENE ELIS LORIE 
EAD EASE CIEE CEERI LLM REE LIT EEE TE SE ES LIME ILLS LET ELE IED. <ausb GUnS0 <SUNDGNEND-GUURD GSRGUGHGLS GNDCNELeSEaLD, Sue alan anes ae 


Bit | 7 | 6 5 | 4 | 3 | 2 | l | Q | 
Byte | | | | | | | | 
0 | Reserved ——— a 7 
o's eames Mae 4 
as anaes ———=_ 
a Ce 
Pee ne 
Sr 8 CC 
—— nee eee ene 


The parameter length specifies the length in bytes of the following Receive Diagnostic parameters. 
The parameter length does not include itself. Since there are six bytes following the parameter 
length byte, the parameter length byte is set to 06H. 


fea * % PLO Ih af OIE OF @ CidvnOsie TiC) TitiC dl AL Lit, (iid Bits TC) TAL wt Das st U 


If bit 0 of the ROM Diagnostic field is set to one, it indicates that the controller ROM has failed. If 
the bit 1 of the ROM Diagnostic field is set to one, it indicates that the drive control ROM has failed. 


If bit 0 of the RAM Diagnostic field is set to one, it indicates that the controller RAM has failed. If 
the bit 1 of the RAM Diagnostic field is set to one, it indicates that the drive control RAM has failed. 


If bit 0 of the Data Buffer Diagnostic field is set to one, it indicates that the controller data buffer has 
failed. If the bit 1 of the Data Buffer Diagnostic field is set to one, it indicates that the drive control 
data buffer has failed. If the bit 2 of the Data Buffer Diagnostic field is set to one, it indicates that 
the drive control error RAM has failed. 


If the bit 0 of the Interface Diagnostic field is set to one, it indicates that the controller/drive conrol 


interface has failed. If the bit 1 of the Interface Diagnostic field is set to one, it indicates that the 
drive control /mechanism control interface has failed. 
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7.1.6 SEND DIAGNOSTIC Command. 


Peripheral Device Type: C.D. ROM 
Operation Code Type: Mandatory 
Operation Code: IDy 
Table 7-19 
SEND DIAGNOSTIC Command 

a;!s«<éa7?sé‘iak;#é‘(iae: Ck OU CUCU Ue Uhl a 
Byte | | | | | | | | | 
0 | Operation Code —_ | 
o------ | ean nnn nnn mane a nn nnn en nn nnn nnn nnn nn mn nnn enn nnn etme en nen nnn nnn nnn en nn anna ne-- +--+ -----| 
1 | Logical Unit Number | Reserved | SelfTest | Reserved | 
Aas Ee AER beryl terme et oe er ete rere ek ne eer eee eee nen ee eee een ee 
2 | Reserved | 
wnennn- | aan nnn nnn nnn en nn nn nnn nn nn nn nnn mmm nn nn nnn nw nn ren re rn nnn nnn nnn nen nnn nnn nnn nennnnn-= === == | 
Si Parameter List Length (MSB) | 
eI a ea | 
4 | Parameter Liat Length (LSB) | 
woe [omen nena nn nn ne nr nn en en ene nner e nnn mn nnn mmm mea a em ete me Se tn are te eA a np | 
5 | Vendor Unique | Reserved | Flag | Link | 


The SEND DIAGNOSTIC Command (Table 7-19) requests the controller to perform diagnostic 7 
tests on itself, on the attached periperal devices, or both. Except when the self-test bit is one , this ( 
command is usually followed by a RECEIVE DIAGNOSTIC RESULTS command. 


A SelfTest bit of one directs the controller to complete its default self-test. If the self-test is 
requested, the parameter list length shall be set to zero. If the self-test bit is set to one and the 
parameter list length is not zero, the command will be terminated with a CHECK CONDITION 
status. The sense key is set to ILLEGAL REQUEST and the additional sense code set to INVALID 
FIELD IN CDB. The controller may not disconnect during self-test . 


If the self-test does not fail, the command will be terminated with a GOOD status; otherwise, the 
command will be terminated with a CHECK CONDITION status and the sense key will be set to 
HARDWARE ERROR. 


The parameter list length specifies the length in bytes of the parameter list that will be transferred 
during the DATA OUT phase. A parameter list length of zero indicates that no data will be 
transferred. This condition will not be considered as an error. 


If the self-test is not requested the controller will return GOOD status upon receiving a valid 
command descriptor block and parameter list. The parameter list length is set to eight if user 
specifed diagnostics are requested. The results of the diagnostic test are returned to the iniuator by a 
RECIEVE DIAGNOSTIC RESULTS command. 
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The SEND DIAGNOSTIC data contains an eight-byte parameter list defined as follows. 


2 Table 7-19-1 
Send Diagnostic Data 
~Bitl 7 «| 6 | 5 | 4 ++| 3 | 2 4 1 1 Of 
Byte | | | | | | | | | 
“Ol Reeved 
ST ameter Length OH) 
OM Dingmestio 
e's aaa RAMDagsic ~—SSCSCSCSCS<S; ST 
as Data BufferDiagosic = SOSOCS~S «7S; ST 
st ——<— 4 
~~. —_ 3 
os aaa — 4 


The parameter length specifies the length in bytes of the following Send Diagnostic parameters. 
The parameter length does not include itself. Since there are six bytes following the parameter 
length byte, the parameter length byte should be set to 06H. 


fA Vd AE ZOTU) it) aiiy Olt OF gd CidvriOs,uc Teld Tc ait Nal (ne Oiagsnosnc associgled a wi ® 
AS One in anv OL OF 2a Gla Pnosnc Dleid Inaic™” Nat Te CidbiOs,ue dssOClatec 
ive. 


Bit O and bit 1 of the ROM Diagnostic field are used for checking the controller ROM and the drive 
control(CDC) ROM respectively. Bit 2 to bit 7 of the ROM Diagnostic field should be set to 0. 


Bit 0 and bit 1 of the RAM Diagnostic field are used for checking the controller RAM and the drive 
control(CDC) RAM respectively. Bit 2 to bit 7 of the RAM Diagnostic field should be set to 0. 


Bit 0 ,bit 1 and bit 2 of the Data Buffer Diagnostic field are used for checking the controller data 
buffer , the drive control(CDC) data buffer and the drive control(CDC) error RAM respectively. 
Bit 3 to bit 7 of the Data Buffer Diagnostic field should be set to 0. 


Bit 0 and bit 1 of the Interface Diagnostic field is used for checking the controller/drive control (..e. 


controller to CDC)interface and the drive control/mechanism (i.e. CDC to CDD) interface 
respectively. Bit 2 to bit 7 of the Interface Diagnostic field should be set to 0. 
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8.1.12 PREVENT/ALLOW MEDIA REMOVAL Command. 


PeripheratDevice Type: C.D. ROM 
Operation Code Type: Mandatory 
Operation Code: LEW 


This command requests that the target enable/disable the removal of the cartridge in the drive. A 
prevent bit of one will inhibit the removal of the cartridge by using the eject disk command or by 
use of the eject button. The emergency pin hole eject mechanism will not be overridden. If the 
initiator issues EJECT DISK command with the PREVENT bit of this command set to one, the 
EJECT DISK command will have CHECK CONDITION status with the sense key of illegal 
request and the additioal sense code of 80H (vendor unique) for prevent media removal. Prevention 
of the cartridge removal condition will be terminated upon receipt of a BUS DEVICE RESET 
message or a hard reset. Refer to section 8.1.12 of ANSI X3T9.2/82-2 Rev. 17B for details. 
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2.5.2. Group 1 Commands for C.D. ROM Devices The Group 1 commands for C.D. 
ROM devices shall be as shown in Table 2.5.2-1. | 
Table 2.5.2-1 
Group 1 Commands for C.D. ROM Devices 


acacia sessomenm eguiindiasiatesnoaumervoniiniGunanvaivnessonaoenssbsbel upontipesanseesaajessetaresne-ov tveoaig ‘tenon ptstasnsiipiretnpisiienestearsaaalipene nonin igravavntiaaeiansitpainiseidigutated pentionaniegeamesrupvaniticuheaiaeedualencemabeiiénasenaguaidinnagicameielsnese=nignonancigpiiinnientpsisiinedtiaanabtpioorsiecpunamhianimapasaian cdatupmnuniinn abies Cantcostniace decal 


OD LE ED OP EE. SD SE SD EF SE EE SS SS S08 DO OD. DODD BOB DBD BD BDF BOB BB BE BOSD BB BBD DBO DDS OD BBB BE SE BL OB DE OEE @ BSS © OB OF C8 OS BOK SDOESE DEE DOD > > ih a cr a ae 


READ CAPACITY 8.2.1 


READ EXTENDED 12.2.1 


SEEK EXTENDED 8.2.4 


12.2.4 


WRITE BUFFER CCS(X3T9.2/85-52) 
READ BUFFER CCS(X3T9.2/85-52) 


a 
er 
DAA SSCHHAAAHDADAWDADADHDSADAD SAA ZAHA ZAAAADR 
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Key: M = Command implementation is Mandatory 
E = Command implementation is Required for SCSI devices that support device independent 
self-configuring software. ec 
O = Command implementation is Optional. ( 
R = Command code is reserved for future standardization. 
V = Command code is available for Apple unique commands. 


8.2.1 READ CAPACITY Command. 


Peripheral Device Type: C.D. ROM 


Operation Code Type: Mandatory 
Operation Code: 25,7 


The READ CAPACITY command requests that the target controller determine the physical size of 
the currently mounted C.D. ROM disc. 


The logical block address bytes, PMI (partial medium indicator) bit and RelAdr (relative address) bit 
are set tO zero in this command. 


The target sends eight bytes to the initiator during the data transfer phase. The first four bytes is the 
logical block address of the last valid logical block address on the medium. The second four bytes 

is the block length in bytes of the logical block on this disc. The logical block address and the block 
length are based on the value of the block length set in the Mode Select parameter. The block length 
is default to 2048 bytes. Refer to section 8.2.1 of ANSI X3T9.2/82-2 for details. ‘a 


12.2.1 READ EXTENDED Command 


Peripheral Device Type: C.D. ROM 


Operation Code Type: | Mandatory 
Operation Code: 281 


After the read the optical pickup is ina HOLD TRACK state for the duration of the inactivity 
time-out. Refer to section 12.2.1 of ANSI X3T9.2/82.2 Rev. 17B for details. 


8.2.4 SEEK EXTENDED Command 


Peripheral Device Type: C.D. ROM 


Operation Code Type: | Mandatory 
Operation Code: 2Byy 


After the seek the optical pickup is in a HOLD TRACK state for the duration of the inactivity 
time-out. Refer to section 8.2.4 of ANSI X3T9.2/82.2 Rev. 17B for details. 
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12.2.4 VERIFY Command. 


Peripheral Device Type: C.D.ROM 
Operation Code Type: Mandatory 
Operation Code: 2Fy 


Table 12-12 
VERIFY Command 
Bit | 7 | 6 | § | 4 | 3 | 2 | l | 0 
Byte | | | | | | | | 


: 


1 | Logical Unit Number | Reserved | BIkVfy=0IBytChk=0 [RelAdr =0! 
oe logical Block Ades SB) CCS 7 
— a“  ° 7 
7 
5 | Logical Block Address (LSB) 

eg | 
a VaiicationLeagh (SB) tC | 
os eae Vaiicaionlengh@sB) | 
“s Vendor Unigae _—— — tae lief 


The VERIFY command (Table 12-12) requests that the target verify the data on the medium based 
on the error recovery parameters setting. This command provides a mean to verify the medium 
without transfering data through the SCSI bus. . 


The BIkVfy (blank verify) bit and the RelAdr (relative address) bit are set to zero. 


during the verification based on the parameter set by the mode select command. The block length 


should be set to 2048 or 2336 bytes in the mode select command. A BytChk bit of one causes a 
byte-by-byte compare of the data on the medium and the data transferred from the initiator. 
Implementation of the byte-by-byte compare (BytChk=1) is not required for C.D. ROM. 


The logical block address specifies the logical block at which the verification operation shall begin. 
The verification length specifies the number of contiguous logical blocks of data that shall be 
vertified. A verification length of zero indicates that no logical blocks shall be verified. This 


condition shall not be considered as an error. Any other value indicates the number of logical 
blocks that shall be verified. 
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2.5.2.1 WRITE BUFFER Command. 


Peripheral Device Type: C.D. ROM ( 
Operation Code Type: Mandatory 
Operation Code: 3By 
Table 2.5.2.1-1 
WRITE BUFFER Command 
Bil 7 | 6 | 5 | 4 %-F 3 | 2 ++ 2 | 9.4 
Byte | | | | | | ! | | 
0 | Operation Code OO | 
“TI Yogical UsitNumber |SSt*CReserved—SSSCSCSCSC*~SC‘<S ed 
~~ ae ee 
trom MS bye) 
si: BuferOfet ~~ ~~ 
rt  eaieatsie ~~ 
—c oC eee ne 
a Transfer Length (@atalengih + 4 header byes) 
re Transfer Length(LS.bye) ~~ ~~ SSS 
“Oo | VedeUngel Road CL Fg) Link 1 


a en nn 


The WRITE BUFFER command (Table 2.5.2.1-1) is used in conjunction with the READ BUFFER 
command as a diagnostic function for testing the target's buffer memory and the SCSI bus integrity. 
There shall be no access to the medium during the execution of this command. 


Data to be transferred is preceded by a four-byte header. The four-byte header consists of all 
reserved bytes as shown in the following diagram. The WRITE BUFFER header is sent as part of 
the data transfer phase to the controller. The purpose is to make the READ BUFFER transfers 
equivalent in byte count. 
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_ Write Buffer Header 
Btl 7 «| «6 «| 5S | 4 | 3)ClUdt#éC<«}tSt)tOO 
Byte | | | | | | | | | 
“Ol Reeved 4 
a ens: —<— ~~ y 
— << ~~~ 
3) oo — 


The function of this command and the meaning of fields within the command descriptor block 
depend on the contents of the mode field. 


Mode Field . ae 
OOB Combined header and data with buffer offset set to zero. 
01B Combined header and data with the buffer offset specifies the byte 
offset within the buffer where the data will be stored. 
10B Reserved. 
11B Reserved. 


The buffer offset is the byte offset within the buffer where the data will be stored. If the controller 


is unable to accept the specified buffer offset, it will return CHECK CONDITION status and it will 
set the sense key to ILLEGAL REQUEST. If the mode field is set to OOB and the buffer offset field 
iS set to nonzero value, the drive will return Check Condition. 


The transfer length specifies the maxium number of bytes that will be transferred during the DATA 
OUT phase. This number includes four bytes of header, so the data length to be stored in the 
target's buffer is transfer length minus four. The initiator should attempt to ensure that the transfer 
length is not greater than four plus the available length that is returned in the header of the READ 


-BUFFER command. If the transfer length exceeds the available length plus four, the controller will 


return CHECK CONDITION status and will set the sense key to LLEGAL REQUEST. If the 
buffer offset plus the transfer length is greater than 64K+4, the drive will generate a Check 
Condition. 
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2.5.2.2 READ BUFFER Command. 


Peripheral Device Type: C.D. ROM 
Operation Code Type: Mandatory 
Operation Code: 3CH 
Table 2.5.2.2-1 
READ BUFFER Command 

Bitl 7 | 6 | 865 | 4 | 3 | 2 | 6] | 860 | 
Byte | | | | | | | | | 
0 Operation Code —_ | 
i a Na | 
1 Logical Unit Number | Reserved | Mode | 
| a Sa ae ee eee at | 
2 Reserved | 
3 Buffer offset (M.S. byte) | 


Buffer offset | 


4 
te a 
5 


Buffer offset (L.S. byte) | 
6 | Allocation Length (MLS. byte) | 


7 | Allocation Length (4 header bytes +datalength) | 


a, Lee ne eee a TR NE LEE ON dna Sala CA DE ie a va 


8 | Allocation Length (L.S. byte) | 


9 | Vendor Unique | Reserved | Flag | Link | 


The READ BUFFER command (Table 2.5.2.2-1) is used in conjunction with the WRITE BUFFER 
command as a diagnostic function for testing the target's buffer memory and the SCSI bus integrity. 
There shall be no access to the medium during the execution of this command. 


A four-byte header followed by data bytes are returned to the initiator during the DATA IN phase. 
The read buffer header is defined below. 
Read Buffer Header 


Bit! 7 | 66 | 65 | 4 | 3 | 2 | 6] 


0 | Reserved | 


1 | Available Length (MLS. byte) | 


Available Length (L.S. byte) | 


The available length specifies the total number of data bytes that are available in the target's data 
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buffer. The number is not reduced to reflect the allocation length nor is it reduced to reflect the 
actual number of bytes written using the WRITE BUFFER command. Following the READ 
BUFFER header, the target shall transfer data from its data buffer. The number of data bytes 
transferred following the READ BUFFER header shall be the lesser of allocation length minus four 
or available length. The buffer offset field plus the available length field is always equal to 64K. 


The function of this command and the meaning of fields within the command descriptor block 
depend on the contents of the mode field. 


Mode Field Description 
OOB Combined header and data with buffer offset set to zero. 
01B Combined header and data with the buffer offset specifies the byte 
offset within the buffer where the data will be read. 
10B Reserved. 
11B Reserved. 


The buffer offset is the byte offset within the buffer where the data will be read. If the controller is 
unable to accept the specified buffer offset, it will retum CHECK CONDITION status and it will set 
the sense key to ILLEGAL REQUEST. If the mode field is set to OOB and the buffer offset field is 
set to nonzero value, the drive will return Check Condition. 


The allocation length specifies the maxium number of bytes that the initiator has allocated for 
returned header and data. An allocation length of zero indicates that no header or data shall be 
transferred. Any other value indicates the maximum number of bytes that shall be transferred. The 
target terminates the DATA IN phase when allocation length bytes of header plus data have been 
transferred or when all available header and data have been transferred to the initiator, whichever 1s 
less. 
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2.5.3 Group 6 Commands for CD-Rom Devices The Group 6 commands for CD-Rom 


devices shall be as shown in Table 2.5.3-1. 4 


Table 2.5.3-1 
Group 6 Commands for CD-Rom Devices 


Operation 

Code Type Command Name Section 
COW M EJECT DISC 20.31 
Cly M READ TOC 2030-2 
C2 M READ Q SUBCODE 2513.0 
C3y M READ HEADER 2.5.3.4 
C4y R | 
CSy R 
Cozy R 
C7H R 
C8 M AUDIO TRACK SEARCH 2.5.5.5 
CoH M AUDIO PLAY 2.5.3.6 
CAH M _ AUDIO PAUSE pa A | 
CB M AUDIO STOP 2.5.3.8 
CCy M AUDIO STATUS _ 2.5.3.9 ( 
CDH M AUDIO SCAN 2.5.3.10 \ 
CEYW R 
CFH R 


Key: M = Command implementation is Mandatory 
E = Command implementation is Required for SCSI devices that support device independent 
self-configuring software. 
O = Command implementation is Optional. 
R = Command code is reserved for future standardization. 
V = Command code is available for vendor unique commands. 
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2.5.3.1 EJECT DISC Command 


Peripheral Device Type: CD-Rom 
Operation Code Type: Mandatory 
Operation Code: COy 


Table 2.5.3.1-1-6 
EJECT DISC Command 

“Bil 7 | 6 #+| 5S | 4 | 3 | 2 1 1 | O 
Byte | | | | | | | | 

0) Operation Code OO 
TE" pgeaUntNumber Reseed IMMED 
ictal cantictbciciceeabineoaiadidanintciestsianneigameteieeincnmennieeies | 

2 | Reserved | 
OD ng —“ ners 
OD = . « 
a 4 amas" aameamamacae aaa 
“_rCC ——a° "4 
“=r — 
Og —_  , "4 
9 _ Reserved | ~=~=————~“‘«@Rve Fag) Lnk 1 


The EJECT DISC command (Table 2.5.3.1-1) specifies for the CD-Rom to eject the disc cartridge. 


¢ IMMED BIT: Function specifies when status of EJECT DISC is returned. 
IMMED BIT = 0: After completion of command execution, CD-ROM returns status. 
IMMED BIT = 1: Before completion, immediately, CD-ROM returns status. 
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2.5.3.2 READ TOC Command 


Peripheral Device Type: CD-Rom 
Operation Code Type: Mandatory 
Operation Code: Cly 


Table 2.5.3.2-1 
READ TOC Command 

Bt! 7 | 6 | 5 | 4 | 3 | 2 | 2 | 0 4 
Byte | | | | | | | | | 

0 Operation Code ttti(‘OSOSOSOSCSCSC~*~*™S 
Te ae ix  t* =. 4 
~~ 
—————————— es 
OO 
ce 

6 | Reserved | | 
7 aT 

8 | Allocation Length (L.S. byte) | 
9 ! _ TYPE | Reserved | | Flag | Link 7 


This command transfers TOC (Table of contents) data from the CD disc to the initiator. 


¢ Track Number(TNO) specifies the starting track number in BCD for the cases when the 
TYPE=10B. The starting track ranges from 01 to 99 in BCD. The TNO byte is reserved for 
TYPE=00B, 01B or 11B. 
When specifying the track number larger than the last TNO or when specifying the track number 
smaller than the first TNO, the check condition status is returned. | 


¢ The allocation length specifies the number of bytes that the initiator has allocated for returned 
data. An allocation length of zero indicates that no data will be transferred. Any other value 
indicates the maximum number of bytes that will be transferred. The target terminates the 
DATA IN phase when allocation length bytes have been transferred or when all available data 
has been transferred to the initiator, whichever is less. 
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Description . 

00 B Transfers the first and last user track number in BCD. 

01B _ Transfers the starting address of the Lead out area in BCD MIN-SEC-FRAME 
format. 

10B Transfers the starting address of each track for a range of tracks starting from the 
track specified in the TNO byte in ascending sequential order until the number of 
bytes specified in the allocation length have been transferred or when all available data 
has been transferred to the initiator, whichever is less. 

11B Reserved. 


(i) TYPE =00B 
This format transfers the first and last user track number in BCD. 
Table 2.5.3.2-2 Read TOC Data (TYPE = 00B) 


Bit! 7 | 6 | 865 | 4 | 3 | 2 | l | O | 
Byte | | | | | | | | | 
ce ree eee ee ee eee 

0 | The first user track number (TNO) in BCD | 
es | ana nan nn nen nnn nnn ene wn een nnn nn nn nen nn nen enn nn nn wenn nen n wen nn ewe nn nnn enn = ne = ee === --| 

1 | The last user track number (TNO) in BCD | 
------- | ann wenmmnn enn enn nn nnn nn nnn nnn enn nnn nn nnn na nnn nn nnn nnn owen nnn nnn nw nen en nnn enn nnn e enn nn enone een =| 

2:4 Reserved Le 
cuca [einen eae ere ae Sake st eaten ieee cnbnasosaten esse essere sate c senor esta eee ashes f 

3 | Reserved | ( 


(ii) TYPE =01B 
This format transfers the starting address of the Lead out area in BCD MIN-SEC-FRAME format. 
Table 2.5.3.2-3 Read TOC Data (TYPE=01B) 


Bit! 7 | 6 | § | 4 | 3 | 2 | 61 | 0 
Bye | | | | | | | | 
Sea ee ee 

0 | Lead-out area starting address in BCD (MIN) | 
Ct teat outaa sang asin BCD SEQ 
2 Lead-out area starting address in BCD (FRAME) | 


ashwe eee | ecapcinietiat mi Wence Wee ann E Rasen aie as Sd ae oe ae cee ee eE eee Beal eo ere e reba allo @Ben ae | 
| e 
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PERL AAAS RELL EIETELD BEES MGS ALTE OIE SELEY TELE ED IE ETE ELLIS EELS IAIN TEL LLILED EEE TIED TIE ELEN CLG EEE TRAIT IEEE EEN TE ELITE AIT SLIDE ATEN LEED EET ELD OAT TEE, CREED IL TEES TE LITE GENSAT IGEN ED TITIES AEE LATED NEI PEI SAINI EIEN: SEU OSBENE RIOG Ba GEE LETT BLEED: ASIEN ING AEST ASOES CES 


(ii) TYPE = 10B 


This format transfers the starting address information (Le. control field, MIN, SEC and FRAME) 
of each track for a range of tracks starting from the track specified in the TNO byte in ascending 
sequential order until the number of bytes specified in the allocation length have been transferred or 
when all available data has been transferred to the initiator, whichever is less. 


Table 2.5.3.2-4 Read TOC Data (TYPE=10B) 


ALERTS CLIP LOIS LY TO EE EIT IC IIIT . 
EAL ATS PREY CHELSIE MILT IS INGE CIT CIO TATA RT EELS CEERI TR EEEED OIC RTESIED (CAIDA CSE CITA STEED 


Bitl 7 | 6 | 5 | 4 | 3 | 2 | 6] | 80 
| 
Byte | | | | | | | | 
| 
0 Reserved | Control field of a specified track : | 


| 

|------ -- == - === == - =n nn nnn nn nnn nn nn nn nnn mn nn nnn mn nnn nnn nnn nnn nnn nnn nnn nnn nen nnn nnn nennnne | 

| Starting point of a specified track (MIN in BCD) | 
wanna nn [ann nnn nn nn ee nnn enn en nnn enn nnn nn nnn enw een nnn nn nnn nnn nnn nnn erm een nnn nen nent en ene nen nnn n anne nenen==- | 

| Starting point of a specified track (SEC in BCD) | 

Oa le ate ar ae ge ee tia eee | 

| Starting point of a specified track (FRAME in BCD) | 


The above four-byte starting address information is repeated for each track in a range of tracks. 
(iv) TYPE = 11B: Reserved. 
plowing is the 8 I . In 


addition the drive should 7 read the TOC saan alter: a hard reset from the SCSI 
bus. 


1) CD ROM drive returns the Check Condition status when any command is sent from the host 
during the TOC read. 


2) CD ROM drive returns a sense key "Not Ready” and an additional sense code of B7(Read TOC 
in progress) when host does Request Sense after check condition as stated in item 1 above. 


3) If the drive is unable to read the TOC in the maximum interval allowed by the Yellow Book, 
then the drive gives a check condition followed by a sense key of "Not Ready" and an additional 
sense code "Unable to recover TOC" (B1). 


4) The Read TOC command will not force the drive to reattempt to read the TOC unless there has 
been a disc change or a power up. 
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ye READ Q SUBCODE Command 


Peripheral Device Type: CD-Rom 
Operation Code Type: Mandatory 
Operation Code: C2yy 


Table 2.5.3.3-1 
READ Q SUBCODE Command 

Btl 7 #| 6 |! 5 | 4 | 3 | 2 | 2 | 0 
Byte | ! | | | | | | 

0 Operation Code ee 
“"T1 Logieal Unit Number << | 
“<—C*~C~*“‘“‘“ai<“ ks SSKXr[?hes SS 
— CC — ° =. 4s 
= a 
= eee 
“ts Se 
“= eee 
ae" ee 
9 "Reserved =  ~—«<I *F#ilag”—sd.'s Link “I 


command (Table 2.5.3.3-1) transfer the current Q SUBCODE ADDRESS loaded from either 
| fa track tO the initiator. 


When the CD-Rom is not in READY state, a check condition is returned. 


The allocation length specifies the number of bytes that the initiator has allocated for returned data. 
An allocation length of zero indicates that no data will be transferred. Any other value indicates the 
maximum number of bytes that will be transferred. The target terminates the DATA IN phase when 
allocation length bytes have been transferred or when all available data has been transferred to the 
initiator, whichever is less. 
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Table 2.5.3.3-2 Format of Q SUBCODE data. 

~ Btl 7 | 6 | 5S | 4 | 3 | 2 | 1 | O 
Bye | | | | | | | | 

Ol Reserved |  ConmolField | 
Io meres 

2 | CD SUBCODE Q ADDRESS data (X) | 
“ZOOS SUBCODE OADDRESSGuQIN 
<a oTTT Te eeer aon a e 
TS SRC GASES a RE 

6 | CD SUBCODE Q ADDRESS data (AMIN) | 
i [mn SUBCODE O ADDRESS dau (ASE)SSCtCSCS 
rs er: CD SUBCODE Q / ADDRESS dam (AFRAME) 


The Control Field is defined as follows. 


| BIT | Content | 
| 3 | 2 | 1 | 0 | | 
| 0 | O | xX | 0 | 2 Audio Channels WITHOUT Pre-Emphasis 

| Q | oO | xX | l | 2 Audio Channels WITH Pre-Emphasis 

| 1 | Oo | xX | 0 | 4 Audio Channels WITHOUT Pre-Emphasis 

iC A | oO | xX | l | 4 Audio Channels WITH Pre-Emphasis 

| Q | 1 | xK | 0 | Data Track 

| 0 | 1 t x | ] | Reserved 

| 1 | 1 | xX It x | Reserved 

| xX It KX | O tl X | Digital Copy Prohibited 

| xX It KX 1! 1 | &X | Digital Copy Permitted 

| | | | | 


ana A a ee ST Te TT TT Ta I! 


The track number specifies the current track number in BCD notation. The value of this has a 
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range of 01 to 99. 
The Index Number(X) specifies the index number in the current track. 


- The MIN, SEC and FRAME fields specifies the relative running time from the beginning of the 
track. 


The AMIN, ASEC and AFRAME fields specifies the relative running time from the beginning of 
the disc. 


2.5.3.4 READ HEADER Command 


Peripheral Device Type: CD-Rom 
Operation Code Type: Mandatory 
Operation Code: C3yH 
Table 2.5.3.4-1 
READ HEADER Command 
Btl 7 | 6 | 5 Jt 4 | 3 | 2 | 1 | 0 
Bye | | | | | | | | 
0 Operation Code CS 
TT Logical UnitNumber Reseed 
DT ical Block Address SB) 
Zeal Block Address SS 
a Serre a Oe eng 
OD ical Block Address@SB) SSS 
“0 C”:t~“‘“‘“( i KXsaKKXK 
~~ ee ee 
— ee | | CC 
i ee er 


ee 


This command returns four bytes of header information of the specified logical block address. This 
command is similar to the READ EXTENDED command, but only the header bytes are returned to 
the initiator. 


System or application program can find out the mode of the block more easily with this command. 
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i | If the logical block address is within an audio track, a CHECK CONDITION will be reported in the 
| status phase. a 


The allocation length specifies the number of bytes that the initiator has allocated for returned data. 
An allocation length of zero indicates that no data will be transferred. Any other value indicates the 
maximum number of bytes that will be transferred. The target terminates the DATA IN phase when 
allocation length bytes have been transferred or when all available data has been transferred to the 
initiator, whichever 1s less. 
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7 Table 2.5.3.4-2 HEADER DATA 
[+ 16 ts +a ts . oT ae 
Byte | | | | | | | | 
~O|  CDabsolueime (AMIN) 
ee ee enn mnie 


pnaniennroutan.saepaneneneennnamennrnnadpensiannetretirrenndarereeieee jena mtrstn tint Prraretp eter tnt itn ndrereentrarartengereemarenenferanietrensbaenan ese anenendpeveenevurannnr sean ptetetestaetsnnnsenatinsnpennenivennipsenentrnennsguentern etnenfbectunaheeneseereurepaseewenfenneapraresernerragarenntenree rere re eR TS 
SOLS LS LT TT CT TT OTD TTD Ee aati D EP SYS NS aaa comeecamee eee ees ae, 
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2.5.3.5 AUDIO TRACK SEARCH Command 


Peripheral Device Type: CD-Rom 
Operation Code Type: Mandatory 
Operation Code: C8yy 


Table 2.5.3.5-1 
AUDIO TRACK SEARCH Command 


1! Logical Unit Number | Play | Play Mode | 
ee ae 
OE  —  —— 
eee ee 
= a ete ie 
<r — ee 
~F a: —el_"s — Fae Lk 


The AUDIO TRACK SEARCH command (Table 2.5.3.5-1) provides a means for positioning the 
optical pickup at address specified by the Search Address parameter. This command returns the 
status byte when the requested search address is found. If the search address is not found, or if the 
drive is not ready, or if the search address is not within an audio track, a CHECK CONDITION 
Status will be returned. 


A PLAY bit of zero indicates the drive will enter the hold track state (i.e. pause) when the search 
address is found. The music will then be played back when a AUDIO PLAY command is issued. 
A PLAY bit of one indicates the drive will output the audio channels in the specified Play Mode 
when the audio address is found. 


The drive can accept and perform another command which will or will not terminate the current 
audio play operation as described in the underlined section under the AUDIO PAUSE command 
description. 


PLA Y-MODE (Byte 01, bits 3 to 0) specifies the play mode as follows: 
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(i) PLAY-MODE = OOOOB: Play with MUTING on. 

(i) PLAY-MODE = 0001B: Play R-channel only thru R-channel only. 
(iu) PLAY-MODE = 0010B: Play L-channel thru R-channel only. 

(iv) PLAY-MODE =0011B: Play L/R channels thru R-channel only. 

(v) PLAY-MODE = 0100B: Play R-Channel thru L-channel only. 

(v1) PLAY-MODE =0101B: Play R-chan thru L, R-chan to R-chan. 

(vu) PLAY-MODE =0110B: Play R thru L, L thru R. 

(vii) PLAY-MODE =0111B: Play R thru L, L/R thru R. 

(ix) PLAY-MODE = 1000B: Play L channel thru L-channel only. 

(x) PLAY-MODE = 1001B: Play L-channel thru L, R thru R, STEREO. 
(x1) PLA Y-MODE = 1010B: Play L-chan thru L, L-chan to R-chan. 

(xu) PLAY-MODE = 1011B: Play L thru L, L/R thru R-channel. 

(xiii) PLAY-MODE = 1100B: Play L/R thru L-channel. 

(xiv) PLAY-MODE = 1101B: Play L/R thru L, R thru R-channel. 

(xv) PLAY-MODE = 1110B: Play L/R thru L-channel, L thru R-channel. 
(xvi) PLAY-MODE = 1111B: Play L/R thru L-channel, L/R thru R-channel. 


The mnemonic for understanding the PLAY-MODE bits is: the right two bits (bits 1 and 0) stand 
for the speaker nght channel output from left and right channels input; the left two bit (bits 3 and 2) 
stand for the speaker left channel output from left and right channels input. 


The TYPE field specifies the format of the Search Address used in the command. The TYPE field 
is defined below. 


TYPE FIELD Description 


00 B Specifies SEARCH address in logical block address format. 
01B Specifies SEARCH address in AMIN, ASEC and AFRAME format. 
10B Specifies SEARCH address in track number (TNO) format. 
11B Reserved. 
Table 2.5.3.5-2 Search Address in Logical Block Address format 
Btl 7 | 6 | 5 | 4 | 3 | 2 | DP LO 
| 
Byte | | | | | | | | 
| 
a ee a eae ne EI 
2 | Logical Block Address (MSB) | 
o------ | panna nn nnn nnn nn nnn nnn nnn nnn n nen ne nen nnn nnn enw nn wenn en enewnwen ewe n ween cee n n= -- nee | 
5-1 Logical Block Address | 
ceeceee |-------- one een = = were ete cc ene nn nnn cecenennnenecncecnenan- = | 
4 | Logical Block Address | 
coccee= |—- wo---------- | 
| 


Logical Block Address (LSB) | 


PD PEEPS AAP EY PSP PLL BP ECP D SIP TOE GP TPL PED OS LED GD ITS GD GPG GP aD | 


The logical block address specifies the logical block address at which the play or pause operation 
will begin. 
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Table 2.5.3.5-3 Search Address in AMIN, ASEC and AFRAME format 


_ = Soe ee ee ee ( 
Bit | 4 | 6 | 5 | 4 | 3 | 2 | l | 0 
| 
Byte | | | | | | | | 
| | | 
SS ne SE LS A See Sea ee SSeS SESS SMO SI SOTA SN ee ee ee ee ee 
eee | 
2 Reserved | 
abe as sce ee ea case a cg ea | 
3 CD-absolute time (AMIN) | 


SSeS a 


CD-absolute time (ASEC) | 


CD-absolute tme (AFRAME) 
a a ae | 


me, 


The AMIN, ASEC and AFRAME fields specifies the relative running time from the beginning of 
the disc. The AMIN field has a range of 00 to 99 in BCD. The ASEC ranges from 00 to 59 in 
BCD. The AFRAME field has a range of 00 to 74 in BCD. 


Table 2.5.3.5-4 Search Address in Track Number (TNO) format 


p) , Reserved | 
“=; nn “a °° 
ay << 
ns en 


a aa l 


The Track Number field specifies the track in BCD notation at which the play or pause operation 
will begin. This field has a range of 01 to 99 in BCD. 
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2.5.3.6 AUDIO PLAY Command 


Peripheral Device Type: CD-Rom 
Operation Code Type: Mandatory 


Operation Code: C9xy 
AUDIO PLAY Command 

“<< Ft Sel SClUklCUOU eO 
Byt | | | | | | | | 

0 Operation Code Swsee cat 
“TT [Logical UnitNumber—1StopAddr | PLAYMODE SI 
en a 88) 
sauit. | enposanesedeneeosantanstnpsiaisaoaee eecceieeenecaeutensthinniaaiianenainaeed 
Od ee ee Ee i 

5 Playback address (LSB) | | 


iced ee tee ee he es a eee eagle l 


3 
: 
a 


ed 


: 
& 
: 
a 
; 


The AUDIO PLAY command (Table 2.5.3.6-1) request that the target position the optical pickup at 
the Playback address specified and output the audio channels in the specified Play Mode when the 
Playback Address is found. This command returns the status byte when the Playback Address is 
found. If the Playback Address is not found, or if the drive is not ready, or if the address is not 
within an audio track, a CHECK CONDITION stamus will be returned . 


The AUDIO PLAY command is used to release a PAUSE(hold track) state after the execution of 
AUDIO TRACK SEARCH command or a PAUSE state after the execution of an AUDIO PAUSE 
command. The AUDIO PLAY command can also be used to set a particular completion address or 
PLAY MODE. 


A Stop Address (StopAddr) bit of zero indicates that the playback address is the starting address for 
the audio play operation. In this case, the stop address should be set by a prior AUDIO STOP 
command. A Stopaddr bit of one indicates that the playback address is the stopping address of the 
audio play operation. In this case, the starting address is set by a prior AUDIO TRACK SEARCH 
command. In both cases, if the stopping address is larger than the end of the current audio track, 
the drive should play up to the stop address or until it encounters a data track. The stop address is 

_ default to be the last audio track after power up or media change. If the stop address is smaller than 


Apple Computer Inc. Confidential Page 59 


February 15, 1988. Apple CD ROM SCSI Command Set 062-2097 Revision 1.4 


the starting address, the drive will return a CHECK CONDITION wi 


th legal Request sens 
and should not play any audio. The minimum difference be nthe audic ess an 


e key 


* 


The drive can accept and perform another command which will or will not terminate the current 
audio play operation as described in the underlined section under the AUDIO PAUSE command 
description. 


PLAY-MODE (Byte 01, bits 3 to 0) specifies the play mode as follows: 


(1) ©PLAY-MODE = OOOOB: Play with MUTING on. 

(iu) PLAY-MODE =0001B: Play R-channel only thru R-channel only. 
(ii) PLAY-MODE =0010B: Play L-channel thru R-channel only. 

(iv) PLAY-MODE =0011B: Play L/R channels thru R-channel only. 

(v) PLAY-MODE =0100B: Play R-Channel thru L-channel only. 

(vi) PLA Y-MODE =0101B: Play R-chan thru L, R-chan to R-chan. 

(vii) PLAY-MODE =0110B: Play R thru L, L thru R. 

(vii) PLAY-MODE = 0111B: Play R thru L, L/R thru R. 

(ix) PLAY-MODE = 1000B: Play L channel thru L-channel only. 

(x) PLAY-MODE = 1001B: Play L-channel thru L, R thru R, STEREO. 
(xi) PLAY-MODE = 1010B: Play L-chan thru L, L-chan to R-chan. 

(xu) PLAY-MODE = 1011B: Play L thru L, L/R thru R-channel. 

(xiii) PLAY-MODE = 1100B: Play L/R thru L-channel. 

(xiv) PLAY-MODE = 1101B: Play L/R thru L, R thru R-channel. 

(xv) PLAY-MODE = 1110B: Play L/R thru L-channel, L thru R-channel. 
(xvi) PLAY-MODE = 1111B: Play L/R thru L-channel, L/R thru R-channel. 


The mnemonic for understanding the PLAY-MODE bits is: the right two bits (bits 1 and 0) stand 
for the speaker right channel output from left and right channels input; the left two bit (bits 3 and 2) ( 
stand for the speaker left channel output from left and right channels input. 


The TYPE field specifies the format of the Playback Address used in the command. The TYPE 
field is defined below. 


TYPE FIELD Description 
00B Specifies Playback address in logical block address format. 
01B Specifies Playback address in AMIN, ASEC and AFRAME format. 
10B Specifies Playback address in track number (TNO) format. 
11B Reserved. 


Table 2.5.3.6-2 Playback Address in Logical Block Address format 


woceeee | mene n nn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nn nnn ew enn nnn nn mene ncn n neem nnn en nnn n een enn == | 


i Astetbeisdscentasseensetee monte ects a mmianmtandeateieeasuanaanciansed 
ik Senn. 2ccicecin chin ae 
tt Merieat Block Address 

5 | Logical Block Address (LSB) | 
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CSD ARDY RELAPSE ALTA EELS ELLIS NE ANE LY LOE TAT TEEN TI ATE SEL A ALI ITED SLD ALE CTY LRAT TATED 
RRR CAA ae SRR AEDS A MEARNS SESE SACLE REOCELETS CELE PERT IED SEARO EES CSI TE AE TE SEIS CITRINE I RCT ECL TTT CECE EI ESENES SGEL I TIE TESTED, TECTED TELE ELLIS TIED CLE EEG TMT RED AE EPO ERIS APET RRs ETERS (EID EES? EEA TEREO SUES COINS CEE LELD GLEE TOALA IDSA 


The logical block address specifies the logical block address at which the play operation will begin 
or end depending on the setting of the StopAddr bit. 


Table 2.5.3.6-3 Playback Address in AMIN, ASEC and AFRAME format 


Bit! 7 | 66 | = 5 | 4 | 3 2 ft | 0 

| 

Byte | | | | | | | | 

| 

tr cS aa 
2 Reserved | 

Sag ee ane ace ats a aac ata ra ac hte | 
3 CD-absolute tme (AMIN) | 


CD-absolute time (ASEC) | 
dei tthe sed aati elec le Rio catdodeceect poeereee ae eed 
CD-absolute tme (AFRAME) | 


| 
| 
| 
| 
------- | nnn ann nn nnn nnn wn nnn nnn nnn nnn mn nnn nn nn nn nnn nnn nn enn nnn nnn nnn nnn nnn nnn nwnnen en enn nn nnnns| 
| 
| 
| 
| 


Coenen nnn ca ial anon beni epninabbigimionsantediensliedmannanitabntaaanmpneteineuipunomiitenumninidpeansassaigpbenocantaeincercegpementaiattpinaaipsasdpacceavaeipaiananpansiandinmasalpeasannadpeanentintjia stan iuiarensssipasassaiiavainialfppmustssaipeareisatiqacarenattipiieansoihiasnmaanipaicmsaniapansianitipasanenligniensdtiiaoiselpncissbaigpmannijimasnaaipaimiminipansnntininl 
EP CRRA AES COLLATERAL AGAINST, Ci ASE ITS RC LA SA ti SAE ATED DU BIE ER GENA TEENS (SYR RITTER EINE LIME ET LED, LEER TITEL LED ELLE IEE D LANE ELEC SALE DE ELLE CGE TOLLE TOLLE NEILL LLY CELE LLL LDE MELE ALLED, CLL EL LILLE IEE IE LLY. LEELA IE LD ALIA LIE LEI (LESLEY SERLEED LEELA ELI 


The AMIN, ASEC and AFRAME fields specifies the relative running time from the beginning of 
the disc. The AMIN field has a range of 00 to 99 in BCD. The ASEC ranges from 00 to 59 in 
BCD. The AFRAME field has a range of 00 to 74 in BCD. 


Table 2.5.3.6 Playback Address in Track Number(TNO) format 


a atin ensue pion ainsi pee ncnlminmis csipean nncesebp masala aomuspnna ogee saahieavagan coaneanaina dasa eidbeonaasirdin aaanieganininndaninaelmensnd I asks epehchcanlpnts i sitselemobedednpactcadepialasausadlpacesenieilipiaassaiadpaen camnibpninietaad 
<TD APA A APATITE TE CENA ea ATCA LNA A TED ET OL LE LD TTS ILE ELT LLL LL EL OTL LD ETT LS ED SS EN ES A TY 


Bil 7 | 6 | 5 | a4 it 2 | @ + a | 0 
| | 

Byte | | | | | | | | 

| 


Bea ie, se teceh tet ee vices eee nes mE En Md Ee aera eee ees a ee ee ene re heer) 


2. | Reserved | 
—CCtCt”t:*=“‘“‘—siSoKVKSsSSSS an 
ce 

=] | Track Number (TNO) | 
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The Track Number field specifies the track in BCD notation at which the play operation will begin at 


the beginning of the specified track or end at the end of the specified track. This field has a range of 
01to99in BCD. — 
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2.5.3.7 AUDIO PAUSE Command 


Peripheral Device Type: CD-Rom 
Operation Code Type: Mandatory 
Operation Code: CA}; 


Table 2.5.3.7-1 
AUDIO PAUSE Command 

~Bitl 7 +! 6 +| 5 | 4 | 3 | 2 1 1 ~«21~O 
Byt | | | | | | | | 

0 | <<< $§&° °° 
“TT 77 Logical Unit Number at !!D!”6ll—<K— 4 
—_ —— ns 
= °C CG “+ 
~~ — 
— a. 
“— — 4 
«Se 
as. ——< 
_ 9 Reserved | CResened Bag Link “I 


The AUDIO PAUSE command (Table 2.5.3.7-1) temporarily stops audio play operation and enter 
the hold track state(i.e. keeps the disc at the same Q SUBCODE address). 


A Pause bit of one has the effect of temporarily stops audio play operation with MUTING ON and 
continuing a search of the same SUBCODE Q ADDRESS. The command is valid for use only 
when the audio play is in progress after the AUDIO TRACK SEARCH or AUDIO PLAY 
commands. A Pause bit of zero release the audio pause operation and resume the audio play 
operation at the same Q subcode address just before the start of the audio pause operation. 


The audio pause(Pause bit = 1). audio plav or audio scan operation can be terminated by a REZERO 
JNIT, READ, SEEK, START A TOP UNE ND DIAGNOST PREVENT/ALLOW 

| A REMOVAL. READ EXTENDED, SEEK EXTENDED, VERIFY, RJEC] DIoC, REAL 
TEADER. AUDIO PLAY(StopAddr =0), AUDIO PAUSE, AUDIO SCAN, or AUDIO TRA 


rent audio pause, audio play or audio scan 


The drive should accept and perform TES READY, RE =ST SENS | 
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Oem: 


READ CAPACITY, WRITE BUFFER. READ BUFFER. READ READ O SUBCODE 
AUDIO STATUS. A WP command withou 


A 2PLA op ACd=1) or AU DIO 
Ne current audio pause, audio play or audio scan oneration in progre 


=rminatine 
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2.5.3.8 AUDIO STOP Command 


Peripheral Device Type: CD-Rom 
Operation Code Type: Mandatory 


Operation Code: CBY 


Table 2.5.3.8-1 
AUDIO STOP Command 

~Btl 7 | 6 | S 1 4 | 3 | 2 | 1 | 0 
Byte | | | | | | | | 

0 Operation Code as 
"TI Logical UnitNumber SC ReservedlSS*~*~‘éResewed 
ee ae 088) 

3 | Stop address | 
—<« 4 ——<_  ¢ 
1 

6 | Reserved | 
= a = 
a — 4 
9 4 TYE | 1 Reserved ts | Flag | Link Z 


The AUDIO STOP command (Table 2.5.3.8-1) specifies the stop address at which the audio play 
operation will stop. The drive will spin down and the optical pickup is held around the area of the 
stop address. 


If the stop address is zero and the TYPE field is OOB, the AUDIO STOP command will perform the 
same function as the REZERO UNIT command. 


The TYPE field specifies the format of the Stop Address used in the command. The TYPE field is 
defined below. 


TYPE FIELD Description 


00 B Specifies Stop address in logical block address format. 

01B Specifies Stop address in AMIN, ASEC and AFRAME format. 
10B Specifies Stop address in track number (TNO) format. 

11B Reserved. 
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Table 2.5.3.8-2 Stop Address in Logical Block Address format 


Bit! 7 | 6 | 5S tt 4 | 3 | 2 | DL | 9. 
| 
Byte | | | | | | | | 


2 : Logical Block Address (MSB) | 
“<= a= °C 
eae gp gical Block Address 
5 ase Block Address 1SB) 7 


The logical block address specifies the logical block address at which the play operation will stop. 


Table 2.5.3.8-3 Stop Address in AMIN, ASEC and AFRAME format 


Bil 7 | 6 | § | 4 | 3 | 2 | 2 | 9 

| | 

Byte | | | | | | | | 

! 

Peace Eee an eee ed nee eee eee, 
2 | Reserved | 

wecccee [eee e eee ere mew enn nen nn nneensenenceennnweeseceereeesarccncecanecsccssescensesensananseeneeerewecccceceen=-= | 
3 | CD-absolute time (AMIN) | 


4 | CD-absolute time (ASEC) | 


Ea LE Oren Re AO ER eT Ce eT eee AR EE 


5 | CD-absolute time (AFRAME) | 


seeeee- |—------------------——-—---------—- cement enn n nen mn en nnee nnn nnn nnn neem nanan nanan =-| 


The AMIN, ASEC and AFRAME fields specifies the relative running time from the beginning of 
the disc. The AMIN field has a range of 00 to 99 in BCD. The ASEC ranges from 00 to 59 in 
BCD. The AFRAME field has a range of 00 to 74 in BCD. 
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Table 2.5.3.8-4 Stop Address in Track Number(TNO) format 


ES CNA A TD RUN CA ES TTL TLD TTT TD I CD CS eT Te TS a a ED SOS ST a Te GS aE NED UD eT 


2 | Reserved | 
a ae —<——< 
“= —— eg 
~“s eee T jukNumber INO) SSS™S~*d 


The Track Number field specifies the track in BCD notation at which the play operation will stop. 
This field has a range of 01 to 99 in BCD. 
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2.5.3.9 AUDIO STATUS Command 


Peripheral Device Type: CD-Rom 
Operation Code Type: Mandatory 
Operation Code: CCH 


Table 2.5.3.9-1 
AUDIO STATUS Command 

Btl 7 #| 6 | 5 | 4 | 3 - 2 | Lt 0 
| 
Byte | | | | | | | | 
| 
- 0 | Operation Code - - 

| 

Dieses ihe ee ele Dahon oeiia ss a a ee oe cena oie aaa ee eee a ee an cuLaseS | 

1 Logical Unit Number | Reserved | 
es Nar ce se ee | 

2 Reserved | 


e 
f | 
a 


4 Reserved | 
Sho —_— "3 
60 — © * 
“<= << 
— Sl hs ———_ «= CS 
9 VReened | SCRaeved a 4 | Flag | Link “I 


This command (Table 2.5.3.9-1) transfers the current audio play status and the starting Q 
SUBCODE address of next track. 


The allocation length specifies the number of bytes that the initiator has allocated for returned data. 
An allocation length of zero indicates that no data will be transferred. Any other value indicates the 
maximum number of bytes that will be transferred. The target terminates the DATA IN phase when 
allocation length bytes have been transferred or when all available data has been transferred to the 
initiator, whichever is less. 


When the CD-Rom is not in READY state, a check condition is returned. 
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Table 2.5.3.9-2 Audio Status Data 


2S EE LT TED TT LS SL LS TL ES ED SST ST TTD ST a SSeS aE eae Seana eee ee sees 


Bit | 7 | 6 | 5 | 4 | 3 | 2 | l | QO 
Bye | | | | | | | | 

0 | Status Field ——_——= 
rr rs —<— Ft it——<  . 
a) —<—  £4« wade. 
TT ent Subcode (AMIN) 
Go ee Sobek SEQ 
WF et Suboods (FRAME) 


The Status field is defined as follows: 


Status Field Description 

00H Audio play operation in progress following execution of AUDIO 
TRACK SEARCH command (Play bit = 1) or AUDIO PLAY 
command. 

01H PAUSE (i.e. hold track state) operation in progress. 

02H MUTING-ON operation in progress after execution of AUDO 
TRACK SEARCH command or AUDIO PLAY command. 

03H Audio play completion status. 

04H Exror occurred during audio play. operation. 

0SH Audio play operation not requested. 


The Control Field of the next track is defined as follows. 


| BIT | Content 
| 


| 2 Audio Channels WITHOUT Pre-Emphasis 
| 2 Audio Channels WITH Pre-Emphasis 

| 4 Audio Channels WITHOUT Pre-Emphasis 
| 4 Audio Channels WITH Pre-Emphasis 

| Data Track 

| Reserved 

| Reserved 

| Digital Copy Prohibited 

| Digital Copy Permitted 

| 


‘(endian 
pees * 
DS DKK PKS PS PS PS 
MMH OM OKO | O 


SEL TTTT RLETEE? CAE EE TTT IE SLO LTE EE TEETER ITED) CETTE MTT RL SETI IT CE TEE OEE TERT CEE TINTS TT LTTE STS CEL OTIS CELG ITED CLEP LES TEL EES PLSD LEED LEED ETE ELE ES TEED LELD CCIE TLE D LETS LEE DATES SII 
EP LEE LEAL CLL LEAL OCLC ET IEP CTL ALLE REELED LOLA TE SEDER IEEE TELA GEOL LEE NETL DELLE PELE LEAD ETT LED LED TE DCL ESS EE DEI LGD LIED. 


-| 
-| 
-| 
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PLA Y-MODE (Byte 01, bits 3 to 0) specifies the play mode status as follows: ( 


PLA Y-MODE = QOOOB: 
PLA Y-MODE = 0001B: 
PLA Y-MODE = 0010B: 
PLA Y-MODE = 0011B: 
PLA Y-MODE = 0100B: 
PLA Y-MODE = 0101B: 
PLA Y-MODE = 0110B: 
PLA Y-MODE = 0111B: 
PLA Y-MODE = 1000B: 
PLA Y-MODE = 1001B: 
PLA Y-MODE = 1010B: 
PLAY-MODE = 1011B: 
PLA Y-MODE = 1100B: 
PLA Y-MODE = 1101B: 
PLAY-MODE = 1110B: 
PLA Y-MODE = 1111B: 


Apple CD ROM SCSI Command Set 


062-2097 Revision 1.4 


Play with MUTING on. 

Play R-channel only thru R-channel only. 
Play L-channel thru R-channel only. 

Play L/R channels thru R-channel only. 
Play R-Channel thru L-channel only. 

Play R-chan thru L, R-chan to R-chan. 
Play R thru L, L thru R. 

Play R thru L, L/R thru R. 

Play L channel thru L-channel only. 

Play L-channel thru L, R thru R, STEREO. 
Play L-chan thru L, L-chan to R-chan. 

Play L thru L, L/R thru R-channel. 

Play L/R thru L-channel. 

Play L/R thru L, R thru R-channel. 

Play L/R thru L-channel, L thru R-channel. 
Play L/R thru L-channel, L/R thru R-channel. 


The mnemonic for understanding the PLAY-MODE bits is: the right two bits (bits 1 and 0) stand 
for the speaker right channel output from left and right channels input; the left two bit (bits 3 and 2) 
stand for the speaker left channel output from left and right channels input. 
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2.5.3.10 _ AUDIO SCAN Command 
Peripheral Device Type: CD-Rom 
Operation Code Type: Mandatory 
Operation Code: CDy 
Table 2.5.3.10-1 
AUDIO SCAN Command 


| 0 Operation Code 

““T\"Logical UnitNumber—SC*d~éDiect“TSS”S*~*~*~<“<‘éR eed 
TP SCN Sig at 88) 
sissteAcmseustehscissinabesedantn ameceetere tn oo ee eomalehsalnbipnoeedlasitisninnaiseeshere | 
ses lacdionisenioasalonomspictsen ca a aemenegees educa laaatestipkenaatacsaneiciieds 
sain keausseaiesaoicyeinignislanetceceetme eee re te ag hoenonahaicnneadcese metas | 

6 | Reserved | 
— eae | 
~~ :C::*“‘—_ | 
eo 


The AUDIO SCAN command requests a fast-forward or fast-reverse scan operation starting from 
the Scan Starting Address. 


The drive can accept and perform another command which will or will not terminate the current 
audio scan operation as described in the underlined section under the AUDIO PAUSE command 
description. 


A direction (DIRECT) bit of zero indicates a fast-forward operation. A DIRECT bit of one indicates 
a fast-reversed operation. 


SCAN Starting Address - Specifies the address to begin the Audio Fast scan at. The manner of 
address definition varies with the TYPE field. 


The TYPE field specifies the format of the Scan Starting Address used in the command. The TYPE 
field is defined below. 
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TYPE FIELD Description 


00B Specifies Scan Starting address in logical block address format. 

0O1B Specifies Scan Starting address in AMIN, ASEC and AFRAME 
format. 

10B Specifies Scan Starting address in track number (TNO) format. 

11B Reserved. 


Table 2.5.3.10-2 Scan Starting Address in Logical Block Address format 


Bitl 7 |! 6 |! 5 | 4 IT 3 | 2 | 21 | 9 
Bye | | | | | | | | 
Se ee 

oe Logical Block Address (MSB) | 
~~ ”—~*~— re ee 
~~ aaa 
“Si ””*Chgieal Block Address LSB) ) 


The logical block address specifies the logical block address at which the Scan operation will begin. 


Table 2.3.5.10-3 Scan Starting Address in AMIN, ASEC and AFRAME format 


Bit! 7 | 66 a) | 4 | 3 | 2 | 6] | 60 
Bye | | | | | | | | 
ae 

2 | Reserved | 
“Jr abso ime AMIN) 
esate a8 

5 | CD-absolute time (AFRAME) | 


wowcee [nem nnn nnn nnn an nn nnn nnn nnn nnn nnn nnn nn nnn nn ewe n nnn nn wenn nme nnn nn nnnn nnn ene nnnn= === --| 


_ eS 
pert cee Siew = . = . 


The AMIN, ASEC and AFRAME fields specifies the relative running time from the beginning of 
the disc. The AMIN field has a range of 00 to 99 in BCD. The ASEC ranges from 00 to 59 in 
BCD. The AFRAME field has a range of 00 to 74 in BCD. 
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Table 2.5.3.10-4 Scan Starting Address in Track Number(TNO) format 


La escent ED HERA RES ARTY SEIS ITE ELIT ETE IPOD ENERO PIE TE ENE REECE ILS. LEB IE LIS ETD TOL LLL IIS IO LIT ALIEN EL NOT “ELT OIEEATS TE TEED: CELLET ELT TE AL CLES LEAN ELENA NRT CIEE IS SENET T EEE EES LEGS) LILLE LEIDEN BEES CITED LETIIN TNTE SET LAEED CREED 


Bit! 7 | 66 | 6§ | 4 | 3 | 2 | 1 | 0 
Byt | | | | | | | | 
Se a ite eens 
2 | Reserved | 
Deed 
OE Reved = SOSC~<C~“‘“<‘<“<; 27D 
5 ek Naber SSS 


The Track Number field specifies the track in BCD notation at which the scan operation will begin. 
This field has a range of 01 to 99 in BCD. 
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Physical 
Depth 
Width 
Height 
Weight 


General 

Disc 
Recording surfaces 
Disc diameter 
Disc center hole 
Thickness 
Track pitch 
Scanning velocity 
Rotation speed 


Latency (average) 

Blocks per rotation 
Data 

Data capacity 


Number of blocks/disc 
Data per block 


Address description 
Audio capacity 
Playing ume 
Data streaming rate 
Blocks per second 
User bytes per second 


SCSI bus transfer rate 

Modes supported 
CD-ROM 
CD-Audio 
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Specifications 


266 mm _ (10.47 inches) 
246mm _ (9.69 inches) 
84mm (3.31 inches) 
40kg (8.8 Ibs.) 


12 cm 

15 mm 

1.2 mm 

1.6 microns (15,875 tracks per inch) 
1.2-1.4 meters per second 

Varies over radius 

~530 to 230 rpm 

~55 to 130 milliseconds 

~8.4 to 19.5 variable 


656 MB, Mode 1 
748 MB, Mode 2 
270,000 

2048 bytes, Mode 1 
2336 bytes, Mode 2 
Minutes, seconds, frames 


1 hour 


75 blocks per second 
153.6K, Mode 1 
175.2K, Mode 2 

800 K per second 


Modes C1 and C2 (Phillips/Sony Yellow book) 
(Phillips/Sony Red book) 
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Environmental — 


Noise (maximum) 
Drive on (seek or non-seek) <46 dB(A) 


Temperature 
Operating Temperature +10°C (+507°F) to +40°C (+104°F) 
Storage (6 months) -30°C (-22°F) to +50°C (122°F) 
Transit (72 hours) -30°C (-22°F) to +55°C (+131°F) 
Humidity 


Classified as Class 1 equipment 


Power requirements 


AC Input CUS and Canada) 120V AC £10%, 58 to 62 Hz 
AC Input (Universal) 100/120/200/220/240V AC +10%, 
48 to 62 Hz 
Power Consumption 
Drive on 40 watts 
Interface 
SCSI expansion ports 50-pin connector 
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